by chigwell · chigwell/telegram-mcp
Personal-account Telegram MCP — Claude reads your chats, manages groups, and sends messages via the official MTProto API.
Uses Telegram's MTProto API (not the Bot API) so it works with your personal account. Useful for personal-productivity flows: triage chats, summarize groups, schedule messages. Respect privacy — chats are sensitive.
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"telegram-mcp-chigwell": {
"command": "uvx",
"args": [
"telegram-mcp"
],
"env": {
"TG_API_ID": "${TG_API_ID}",
"TG_API_HASH": "${TG_API_HASH}"
}
}
}
}Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.
{
"mcpServers": {
"telegram-mcp-chigwell": {
"command": "uvx",
"args": [
"telegram-mcp"
],
"env": {
"TG_API_ID": "${TG_API_ID}",
"TG_API_HASH": "${TG_API_HASH}"
}
}
}
}Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.
{
"mcpServers": {
"telegram-mcp-chigwell": {
"command": "uvx",
"args": [
"telegram-mcp"
],
"env": {
"TG_API_ID": "${TG_API_ID}",
"TG_API_HASH": "${TG_API_HASH}"
}
}
}
}Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".
{
"mcpServers": {
"telegram-mcp-chigwell": {
"command": "uvx",
"args": [
"telegram-mcp"
],
"env": {
"TG_API_ID": "${TG_API_ID}",
"TG_API_HASH": "${TG_API_HASH}"
}
}
}
}Same shape as Claude Desktop. Restart Windsurf to pick up changes.
{
"mcpServers": [
{
"name": "telegram-mcp-chigwell",
"command": "uvx",
"args": [
"telegram-mcp"
]
}
]
}Continue uses an array of server objects rather than a map.
{
"context_servers": {
"telegram-mcp-chigwell": {
"command": {
"path": "uvx",
"args": [
"telegram-mcp"
]
}
}
}
}Add to context_servers. Zed hot-reloads on save.
claude mcp add telegram-mcp-chigwell -- uvx telegram-mcpOne-liner. Verify with claude mcp list. Remove with claude mcp remove.
When to use: You're overwhelmed; want a per-chat summary and follow-up suggestions.
Outcome: Inbox-zero on Telegram with proposed replies.
Persist drafts before sending
| Tool | Inputs | When to call | Cost |
|---|---|---|---|
| list_chats | (see docs) | List chats with unread counts | 1 call |
| fetch_messages | (see docs) | Pull messages from a chat | 1 call |
| send_message | (see docs) | Send a message | 1 call |
| search | (see docs) | Search across chats | 1 call |
user-accountexpose session file; it's as good as your passwordAUTH_KEY_DUPLICATEDSession collision; delete session and re-auth
| Alternative | When to use it instead | Tradeoff |
|---|---|---|
| Bot API integration | You need a bot, not a personal account | No personal-DM access |