Telegram MCP Server for VS Code
io.github.tolboy/telegram-mcp-tdlib
Local-first TDLib Telegram MCP server with 110 tools, account isolation and production guardrails.
client:VS Code
transport:stdio
runtime:oci
Install Telegram MCP Server in VS Code
.vscode/mcp.json
{
"inputs": [
{
"type": "promptString",
"id": "tdlib-api-id",
"description": "TDLIB_API_ID",
"password": true
},
{
"type": "promptString",
"id": "tdlib-api-hash",
"description": "TDLIB_API_HASH",
"password": true
},
{
"type": "promptString",
"id": "tdlib-phone-number",
"description": "TDLIB_PHONE_NUMBER",
"password": true
},
{
"type": "promptString",
"id": "tdlib-auth-code",
"description": "TDLIB_AUTH_CODE",
"password": true
},
{
"type": "promptString",
"id": "tdlib-2fa-password",
"description": "TDLIB_2FA_PASSWORD",
"password": true
},
{
"type": "promptString",
"id": "mcp-read-only",
"description": "MCP_READ_ONLY",
"password": true
},
{
"type": "promptString",
"id": "mcp-tool-profile",
"description": "MCP_TOOL_PROFILE",
"password": true
}
],
"servers": {
"telegram-mcp-tdlib": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/tolboy/telegram-mcp-tdlib:1.16.2-stdio"
],
"env": {
"TDLIB_API_ID": "${input:tdlib-api-id}",
"TDLIB_API_HASH": "${input:tdlib-api-hash}",
"TDLIB_PHONE_NUMBER": "${input:tdlib-phone-number}",
"TDLIB_AUTH_CODE": "${input:tdlib-auth-code}",
"TDLIB_2FA_PASSWORD": "${input:tdlib-2fa-password}",
"MCP_READ_ONLY": "${input:mcp-read-only}",
"MCP_TOOL_PROFILE": "${input:mcp-tool-profile}"
}
}
}
}
VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs