Remote MCP Server

SimpleTgChat MCP

Let Claude send messages, photos, polls and more to one Telegram chat - no install, no server to run.

Build your URLView on GitHub

What is this?

A minimal MCP server built for exactly one job.

☁️

Fully remote

Hosted on Vercel. Nothing to install or run locally.

💬

One chat

Every call targets a single, pre-configured Telegram chat.

🔒

Stateless

Your token and chat ID live only in the URL. Nothing is stored.

🧰

20+ tools

Send, read, and manage messages via the full Telegram Bot API.

Get your connector URL

Paste your bot token and chat ID - the link updates as you type.

Connector URL
https://simple-tg-chat-mcp.vercel.app/api/mcp?token=<BOT_TOKEN>&chat=<CHAT_ID>
Claude Code command
claude mcp add --transport http Telegram "https://simple-tg-chat-mcp.vercel.app/api/mcp?token=<BOT_TOKEN>&chat=<CHAT_ID>"

Keep this URL private - anyone who has it can send messages through your bot. No sign-up or account needed; the server is stateless and multi-tenant.

Available tools

All of it runs remote - every call goes straight to the Telegram Bot API.

Reading

get_updatesget_file

Sending

get_mesend_messagesend_photosend_documentsend_videosend_audiosend_voicesend_animationsend_media_groupsend_locationsend_venuesend_contactsend_pollsend_dicesend_chat_action

Managing

edit_message_textedit_message_captiondelete_messagepin_messageunpin_messageunpin_all_messagesforward_messagecopy_message
read-only write destructive

Setup

Four steps, five minutes.

  1. Create a bot

    Message @BotFather on Telegram, send /newbot, and save the API token it gives you.

  2. Get your chat ID

    Message your bot (or add it to a group/channel), then open https://api.telegram.org/bot<TOKEN>/getUpdates in a browser and read chat.id from the response.

  3. Build your connector URL

    Use the form above to generate your personal MCP URL.

  4. Connect it to Claude

    Add it as a custom connector in Claude.ai, or via the CLI in Claude Code.

    Claude.ai / Claude Desktop

    1. Settings → Connectors → Add custom connector
    2. Name it (e.g. "Telegram")
    3. Paste your connector URL
    4. Save

    Claude Code (CLI)

    claude mcp add --transport http Telegram "https://simple-tg-chat-mcp.vercel.app/api/mcp?token=<BOT_TOKEN>&chat=<CHAT_ID>"