Для чего этот сервер?

Этот MCP-сервер подключает AI-ассистентов к Telegram, чтобы они могли работать с диалогами напрямую. Он читает сообщения, проверяет непрочитанные чаты, отправляет черновики и управляет прочитанным — прямо из интерфейса нейросети. Вместо того чтобы самому листать десятки чатов, пользователь просит ассистента найти важное, суммировать переписку или подготовить ответ. Сервер экономит время, делегируя рутину AI.

Каталог MCP
chaindead/telegram-mcp

chaindead/telegram-mcp

от chaindead

Telegram MCP сервер подключает AI-ассистентов к вашему аккаунту: чтение диалогов, отправка сообщений, отслеживание уведомлений. Работает с Claude, Cursor. Упрощает управление перепиской и автоматизацию ответов.

Github NPM Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

Telegram MCP server

The server is a bridge between the Telegram API and the AI assistants and is based on the Model Context Protocol.

Важно
Ensure that you have read and understood the Telegram API Terms of Service before using this server. Any misuse of the Telegram API may result in the suspension of your account.

What is MCP?
What does this server do?
- Capabilities
- Prompt examples
Installation
- Homebrew
- NPX
- From Releases
  - MacOS
  - Linux
  - Windows
- From Source
Configuration
Star History

What is MCP?

The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop or Cursor, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.

What does this server do?

Capabilities

Get current account information (tool: tg_me)
List dialogs with optional unread filter (tool: tg_dialogs)
Mark dialog as read (tool: tg_read)
Retrieve messages from specific dialog (tool: tg_dialog)
Send draft messages to any dialog (tool: tg_send)

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

`0.2.0`основная	28.02.2026
`0.1.23`	21.08.2025
`0.1.22`	18.04.2025
`0.1.21`	08.04.2025
`0.1.14-SNAPSHOT-59a2970`	08.04.2025

Выберите клиент, чтобы установить chaindead/telegram-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "chaindead-telegram-mcp-7uxzs6ussd": {
      "command": "npx",
      "args": [
        "-y",
        "@chaindead/telegram-mcp"
      ],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "chaindead-telegram-mcp-7uxzs6ussd": {
      "command": "npx",
      "args": [
        "-y",
        "@chaindead/telegram-mcp"
      ],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "chaindead-telegram-mcp-7uxzs6ussd": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@chaindead/telegram-mcp"
      ],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"chaindead-telegram-mcp-7uxzs6ussd\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@chaindead/telegram-mcp\"],\"env\":{\"TG_APP_ID\":\"<your-api-id>\",\"TG_API_HASH\":\"<your-api-hash>\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

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

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "chaindead-telegram-mcp-7uxzs6ussd": {
      "command": "npx",
      "args": [
        "-y",
        "@chaindead/telegram-mcp"
      ],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add chaindead-telegram-mcp-7uxzs6ussd --env TG_APP_ID=<your-api-id> --env TG_API_HASH=<your-api-hash> -- npx -y @chaindead/telegram-mcp

Либо через JSON-конфиг:

claude mcp add-json chaindead-telegram-mcp-7uxzs6ussd "{\"command\":\"npx\",\"args\":[\"-y\",\"@chaindead/telegram-mcp\"],\"env\":{\"TG_APP_ID\":\"<your-api-id>\",\"TG_API_HASH\":\"<your-api-hash>\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add chaindead-telegram-mcp-7uxzs6ussd --env TG_APP_ID=<your-api-id> --env TG_API_HASH=<your-api-hash> -- npx -y @chaindead/telegram-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.chaindead-telegram-mcp-7uxzs6ussd]
command = "npx"
args = ["-y", "@chaindead/telegram-mcp"]

[mcp_servers.chaindead-telegram-mcp-7uxzs6ussd.env]
TG_APP_ID = "<your-api-id>"
TG_API_HASH = "<your-api-hash>"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите chaindead/telegram-mcp, а в поле команды запуска — строку ниже:

npx -y @chaindead/telegram-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "chaindead-telegram-mcp-7uxzs6ussd": {
      "command": "npx",
      "args": [
        "-y",
        "@chaindead/telegram-mcp"
      ],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "chaindead-telegram-mcp-7uxzs6ussd": {
      "command": "npx",
      "args": [
        "-y",
        "@chaindead/telegram-mcp"
      ],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например chaindead-telegram-mcp-7uxzs6ussd.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: chaindead-telegram-mcp-7uxzs6ussd
    command: npx
    args:
      - "-y"
      - "@chaindead/telegram-mcp"
    env:
      TG_APP_ID: <your-api-id>
      TG_API_HASH: <your-api-hash>

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "chaindead-telegram-mcp-7uxzs6ussd": {
      "command": "npx",
      "args": [
        "-y",
        "@chaindead/telegram-mcp"
      ],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@chaindead/telegram-mcp"
  ],
  "env": {
    "TG_APP_ID": "<your-api-id>",
    "TG_API_HASH": "<your-api-hash>"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx