Skip to content
VS Code

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

Telegram MCP Server in other clients