io.github.alexeyleshchenko/fast-mcp-telegram MCP Server

Name: io.github.alexeyleshchenko/fast-mcp-telegram MCP Server
Author: io.github.alexeyleshchenko

io.github.alexeyleshchenko/fast-mcp-telegram

Repository Registry

What is the io.github.alexeyleshchenko/fast-mcp-telegram MCP server?

Multi-tenant Telegram gateway for AI agents — HTTP+stdio, 8 tools, MTProto User API

How to install io.github.alexeyleshchenko/fast-mcp-telegram

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

API_ID
required
Telegram API ID from my.telegram.org
API_HASH
required
secret
Telegram API Hash from my.telegram.org
SERVER_MODE
Server mode: stdio (local), http-no-auth (dev), http-auth (prod)
SESSION_DIR
Custom session directory (defaults to ~/.config/fast-mcp-telegram/)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fast-mcp-telegram": {
      "command": "uvx",
      "args": [
        "fast-mcp-telegram"
      ],
      "env": {
        "API_ID": "<YOUR_API_ID>",
        "API_HASH": "<YOUR_API_HASH>",
        "SERVER_MODE": "<YOUR_SERVER_MODE>",
        "SESSION_DIR": "<YOUR_SESSION_DIR>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "fast-mcp-telegram": {
      "command": "uvx",
      "args": [
        "fast-mcp-telegram"
      ],
      "env": {
        "API_ID": "<YOUR_API_ID>",
        "API_HASH": "<YOUR_API_HASH>",
        "SERVER_MODE": "<YOUR_SERVER_MODE>",
        "SESSION_DIR": "<YOUR_SESSION_DIR>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "fast-mcp-telegram": {
      "command": "uvx",
      "args": [
        "fast-mcp-telegram"
      ],
      "env": {
        "API_ID": "<YOUR_API_ID>",
        "API_HASH": "<YOUR_API_HASH>",
        "SERVER_MODE": "<YOUR_SERVER_MODE>",
        "SESSION_DIR": "<YOUR_SESSION_DIR>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "fast-mcp-telegram": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "fast-mcp-telegram"
      ],
      "env": {
        "API_ID": "<YOUR_API_ID>",
        "API_HASH": "<YOUR_API_HASH>",
        "SERVER_MODE": "<YOUR_SERVER_MODE>",
        "SESSION_DIR": "<YOUR_SESSION_DIR>"
      }
    }
  }
}

Claude Code

claude mcp add fast-mcp-telegram --env API_ID=<YOUR_API_ID> --env API_HASH=<YOUR_API_HASH> --env SERVER_MODE=<YOUR_SERVER_MODE> --env SESSION_DIR=<YOUR_SESSION_DIR> -- uvx fast-mcp-telegram