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

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

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

chigwell/telegram-mcp

от chigwell

Отправляет сообщения, управляет чатами, контактами и медиа в Telegram: 80+ операций для автоматизации переписки и администрирования.

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

README

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

Версии

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

A Telegram integration for Claude, Cursor, and other MCP-compatible clients. It exposes Telegram account, chat, message, contact, media, folder, and admin operations through the Model Context Protocol using Telethon.

🤖 MCP in Action

Basic Telegram MCP usage in Claude:

Asking Claude to analyze chat history and send a response:

Message sent successfully:

Skills & Practical Workflows
What It Can Do
Requirements
Quick Start
MCP Client Configuration
Multi-Account Setup
Device Identity
Expected Account Check
Proxy Support
File Path Security
Chat Access Privacy (Allowlist)
Docker
Development
Security Notes
Troubleshooting
License

Skills & Workflows

Looking for ready-to-use workflows, prompt examples, or integration recipes? Explore the Skills Documentation for step-by-step guides on:

Summarizing unread messages safely
Drafting replies without sending
Triaging action items & urgent requests
Searching chat history and expanding context

What It Can Do

The server currently includes 80+ MCP tools grouped into these areas:

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

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

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

Любой клиент

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

{
  "mcpServers": {
    "chigwell-telegram-mcp-5ndi1593on": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/telegram-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "TELEGRAM_API_ID": "your_api_id_here",
        "TELEGRAM_API_HASH": "your_api_hash_here",
        "TELEGRAM_SESSION_STRING": "your_session_string_here"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "chigwell-telegram-mcp-5ndi1593on": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/telegram-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "TELEGRAM_API_ID": "your_api_id_here",
        "TELEGRAM_API_HASH": "your_api_hash_here",
        "TELEGRAM_SESSION_STRING": "your_session_string_here"
      }
    }
  }
}

VS Code

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

{
  "servers": {
    "chigwell-telegram-mcp-5ndi1593on": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/telegram-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "TELEGRAM_API_ID": "your_api_id_here",
        "TELEGRAM_API_HASH": "your_api_hash_here",
        "TELEGRAM_SESSION_STRING": "your_session_string_here"
      }
    }
  }
}

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

code --add-mcp "{\"name\":\"chigwell-telegram-mcp-5ndi1593on\",\"type\":\"stdio\",\"command\":\"uv\",\"args\":[\"--directory\",\"/full/path/to/telegram-mcp\",\"run\",\"main.py\"],\"env\":{\"TELEGRAM_API_ID\":\"your_api_id_here\",\"TELEGRAM_API_HASH\":\"your_api_hash_here\",\"TELEGRAM_SESSION_STRING\":\"your_session_string_here\"}}"

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": {
    "chigwell-telegram-mcp-5ndi1593on": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/telegram-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "TELEGRAM_API_ID": "your_api_id_here",
        "TELEGRAM_API_HASH": "your_api_hash_here",
        "TELEGRAM_SESSION_STRING": "your_session_string_here"
      }
    }
  }
}

Claude Code

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

claude mcp add chigwell-telegram-mcp-5ndi1593on --env TELEGRAM_API_ID=your_api_id_here --env TELEGRAM_API_HASH=your_api_hash_here --env TELEGRAM_SESSION_STRING=your_session_string_here -- uv --directory /full/path/to/telegram-mcp run main.py

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

claude mcp add-json chigwell-telegram-mcp-5ndi1593on "{\"command\":\"uv\",\"args\":[\"--directory\",\"/full/path/to/telegram-mcp\",\"run\",\"main.py\"],\"env\":{\"TELEGRAM_API_ID\":\"your_api_id_here\",\"TELEGRAM_API_HASH\":\"your_api_hash_here\",\"TELEGRAM_SESSION_STRING\":\"your_session_string_here\"}}"

Codex

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

codex mcp add chigwell-telegram-mcp-5ndi1593on --env TELEGRAM_API_ID=your_api_id_here --env TELEGRAM_API_HASH=your_api_hash_here --env TELEGRAM_SESSION_STRING=your_session_string_here -- uv --directory /full/path/to/telegram-mcp run main.py

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

[mcp_servers.chigwell-telegram-mcp-5ndi1593on]
command = "uv"
args = ["--directory", "/full/path/to/telegram-mcp", "run", "main.py"]

[mcp_servers.chigwell-telegram-mcp-5ndi1593on.env]
TELEGRAM_API_ID = "your_api_id_here"
TELEGRAM_API_HASH = "your_api_hash_here"
TELEGRAM_SESSION_STRING = "your_session_string_here"

Perplexity

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

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

uv --directory /full/path/to/telegram-mcp run main.py

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

Windsurf

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

{
  "mcpServers": {
    "chigwell-telegram-mcp-5ndi1593on": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/telegram-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "TELEGRAM_API_ID": "your_api_id_here",
        "TELEGRAM_API_HASH": "your_api_hash_here",
        "TELEGRAM_SESSION_STRING": "your_session_string_here"
      }
    }
  }
}

Cline

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

{
  "mcpServers": {
    "chigwell-telegram-mcp-5ndi1593on": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/telegram-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "TELEGRAM_API_ID": "your_api_id_here",
        "TELEGRAM_API_HASH": "your_api_hash_here",
        "TELEGRAM_SESSION_STRING": "your_session_string_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

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

mcpServers:
  - name: chigwell-telegram-mcp-5ndi1593on
    command: uv
    args:
      - "--directory"
      - "/full/path/to/telegram-mcp"
      - "run"
      - "main.py"
    env:
      TELEGRAM_API_ID: your_api_id_here
      TELEGRAM_API_HASH: your_api_hash_here
      TELEGRAM_SESSION_STRING: your_session_string_here

Zed

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

{
  "context_servers": {
    "chigwell-telegram-mcp-5ndi1593on": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/telegram-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "TELEGRAM_API_ID": "your_api_id_here",
        "TELEGRAM_API_HASH": "your_api_hash_here",
        "TELEGRAM_SESSION_STRING": "your_session_string_here"
      }
    }
  }
}

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

{
  "command": "uv",
  "args": [
    "--directory",
    "/full/path/to/telegram-mcp",
    "run",
    "main.py"
  ],
  "env": {
    "TELEGRAM_API_ID": "your_api_id_here",
    "TELEGRAM_API_HASH": "your_api_hash_here",
    "TELEGRAM_SESSION_STRING": "your_session_string_here"
  }
}