MCP Telegram

Name: MCP Telegram
Author: mcp-telegram

mcp-telegram

Get started Repository Website & docs

Connects a personal Telegram account over MTProto to read chats, search messages, download media and manage contacts.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

Local

claude mcp add telegram-telegram --env TELEGRAM_API_ID='<TELEGRAM_API_ID>' --env TELEGRAM_API_HASH='<TELEGRAM_API_HASH>' -- npx -y @overpod/mcp-telegram

~/.codex/config.toml

[mcp_servers.telegram-telegram]
command = "npx"
args = ["-y", "@overpod/mcp-telegram"]
env = { TELEGRAM_API_ID = "<TELEGRAM_API_ID>", TELEGRAM_API_HASH = "<TELEGRAM_API_HASH>" }

# codex mcp add telegram-telegram --env TELEGRAM_API_ID='<TELEGRAM_API_ID>' --env TELEGRAM_API_HASH='<TELEGRAM_API_HASH>' -- npx -y @overpod/mcp-telegram

~/.cursor/mcp.json

{
  "mcpServers": {
    "telegram-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "telegram-telegram": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "telegram-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "telegram-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "telegram-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "@overpod/mcp-telegram"
      ],
      "env": {
        "TELEGRAM_API_ID": "<TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<TELEGRAM_API_HASH>"
      }
    }
  }
}

Remote

claude mcp add --transport http telegram-telegram https://mcp.mcp-telegram.com/mcp

~/.codex/config.toml

[mcp_servers.telegram-telegram]
url = "https://mcp.mcp-telegram.com/mcp"

# codex mcp add telegram-telegram --url https://mcp.mcp-telegram.com/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "telegram-telegram": {
      "url": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "telegram-telegram": {
      "type": "http",
      "url": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "telegram-telegram": {
      "httpUrl": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}

claude_desktop_config.json · Customize › Connectors › Add custom connector

{
  "mcpServers": {
    "telegram-telegram": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mcp-telegram.com/mcp"
      ]
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "telegram-telegram": {
      "url": "https://mcp.mcp-telegram.com/mcp"
    }
  }
}

Environment variables

TELEGRAM_API_ID
TELEGRAM_API_HASH

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Local

Remote

Environment variables

Related