Telegram Channel Scraper MCP Server

An MCP (Model Context Protocol) server that lets Claude, Cursor, and any MCP-compatible AI scrape public Telegram channels — no Telegram account, no phone number, no API key required.

Powered by the khadinakbar/telegram-channel-scraper Apify actor.

Tools

| Tool | Description | |------|-------------| | telegram_scrape_messages | Scrape messages from one or more public channels | | telegram_get_channel_info | Get subscriber count, title, verification status | | telegram_discover_related_channels | Find related channels via forwarded message analysis | | telegram_extract_leads | Extract email addresses and links for lead generation |

Prerequisites

1. Free Apify account (no credit card required for free tier)
2. Your Apify API token from console.apify.com/account/integrations

Installation

Option 1: Hosted MCP — Zero Setup (Recommended)

Use the Apify-hosted MCP endpoint — no install, no npm, just add this URL to your MCP client:

https://mcp.apify.com/?tools=actors,docs,get-actor-run,get-actor-run-list,khadinakbar/telegram-channel-scraper

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "telegram-scraper": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=actors,docs,get-actor-run,get-actor-run-list,khadinakbar/telegram-channel-scraper",
      "headers": {
        "Authorization": "Bearer YOUR_APIFY_TOKEN"
      }
    }
  }
}

Option 2: npm / npx (Local Install)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "telegram-scraper": {
      "command": "npx",
      "args": ["-y", "telegram-channel-scraper-mcp-server"],
      "env": {
        "APIFY_TOKEN": "your_apify_token_here"
      }
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor / VS Code / Other MCP Clients

{
  "mcpServers": {
    "telegram-scraper": {
      "command": "npx",
      "args": ["-y", "telegram-channel-scraper-mcp-server"],
      "env": {
        "APIFY_TOKEN": "your_apify_token_here"
      }
    }
  }
}

Manual Installation

npm install -g telegram-channel-scraper-mcp-server
APIFY_TOKEN=your_token telegram-channel-scraper-mcp

Usage Examples

Once connected, ask Claude naturally:

"Scrape the last 100 messages from @telegram"
"How many subscribers does @durov have?"
"Find email addresses in @somebusinesschannel"
"What channels are related to @cryptonews?"
"Extract leads from @marketingchannel and @salesdeals"

Tool Reference

telegram_scrape_messages

Scrape messages from public Telegram channels.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | channels | string[] | required | Channel usernames without @ (e.g. ["telegram"]) | | max_messages | number | 50 | Max messages per channel (1–1000) | | include_media | boolean | false | Include media URLs | | include_reactions | boolean | false | Include reaction counts | | extract_emails | boolean | true | Extract email addresses from text | | extract_links | boolean | true | Extract URLs from text | | since_last_run | boolean | false | Incremental mode — only new messages | | response_format | string | "markdown" | "markdown" or "json" |

telegram_get_channel_info

Get metadata for a channel.

| Parameter | Type | Default | Description | |-----------|------|---------|----

... View full README on GitHub