Install Telegram MCP Server for Claude Desktop
Claude Desktop reads mcpServers from claude_desktop_config.json. Restart the app after saving.
- Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/.config/Claude/claude_desktop_config.json on Linux.
- Paste the JSON config below.
- Replace placeholder secrets, then restart the client if it does not reload on its own.
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"tolboy-telegram-mcp-tdlib": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/tolboy/telegram-mcp-tdlib:1.17.3-stdio"
],
"env": {
"TDLIB_API_ID": "",
"TDLIB_API_HASH": "YOUR_TDLIB_API_HASH",
"TDLIB_PHONE_NUMBER": "YOUR_TDLIB_PHONE_NUMBER",
"TDLIB_AUTH_CODE": "YOUR_TDLIB_AUTH_CODE",
"TDLIB_2FA_PASSWORD": "YOUR_TDLIB_2FA_PASSWORD",
"MCP_READ_ONLY": "true",
"MCP_TOOL_PROFILE": "reader"
}
}
}
}