Remote MCP server

Telegram MCP server for ChatGPT and Claude

ChatMate is a hosted Telegram MCP server and connector. Add one URL to ChatGPT, Claude, Cursor or another MCP client and sign in with Telegram. Your AI reads the chats you choose and acts in them when you ask. No api_id, no api_hash, no userbot.

One URL for every AI

MCP server URL
https://www.getchatmate.com/api/connector/mcp
Transport
Streamable HTTP.
Sign-in
OAuth 2.1 with PKCE and dynamic client registration. You sign in with Telegram in the browser, with no API keys.
Hosting
Runs on ChatMate’s servers. Nothing to install on your computer or keep running.
Access
Only the chats you connect, from the moment you connect them. Messages are kept for up to 30 days.
Price
Free. Your AI subscription is paid to its provider.

Connect in three steps

  1. Create your bot

    Open @chatmate_agent and create your personal bot with its own @username. It’s free, with no BotFather token to copy.

  2. Choose your chats

    For private chats, turn on Secretary Mode in BotFather and add the bot to Chat Automation. In a group, add it as an admin. No Telegram Premium needed.

  3. Add the server to your AI

    Add the URL above as a custom connector or remote MCP server and sign in with Telegram. Then ask your AI about your chats.

In your client

  • ChatGPT

    On chatgpt.com in the browser: Plugins → + → Add custom MCP server. Name it ChatMate, paste the URL, choose OAuth.

    ChatGPT guide
  • Claude

    Customize → Connectors → Add custom connector. Add it once and it works on the web, in Claude Desktop, in the mobile apps and in Claude Code with the same account.

    Claude guide
  • Claude Code

    Or add it from the terminal, then sign in from /mcp.

    Terminal
    claude mcp add --transport http --scope user chatmate https://www.getchatmate.com/api/connector/mcp
    Claude Code guide
  • Codex

    In the ChatGPT desktop app, Codex already has what you added in ChatGPT. For the CLI and the IDE extension:

    Terminal
    codex mcp add chatmate --url https://www.getchatmate.com/api/connector/mcp
    Codex guide
  • Cursor

    One click from the guide, or this entry in ~/.cursor/mcp.json:

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "chatmate": {
          "url": "https://www.getchatmate.com/api/connector/mcp"
        }
      }
    }
    Cursor guide
  • Other clients

    Other apps on your computer that add remote MCP servers with OAuth take the same URL and sign in with Telegram. An app that runs only local stdio servers can use mcp-remote:

    Terminal
    npx -y mcp-remote https://www.getchatmate.com/api/connector/mcp --callback-path /callback --auth-timeout 300
    All guides

What your AI gets

ChatMate’s tools appear in your AI after you sign in. The main ones:

Read and find

list_chats
The chats you connected, their type and history.
search_messages
Search by words and their forms across chats.
get_messages
A chat’s history, one person’s messages or a forum topic.
get_message_context
A message with its replies, quotes and the messages around it.
catch_up
What happened since a given time: who is waiting, what was promised.
list_owner_asks
Who is waiting for your answer.
list_people
People who wrote in your chats, and where they appear.
get_attachment
Documents, photos and voice message transcripts.

Act on your request

send_to_chat
A text reply in a connected chat.
telegram_send_task_list
A task list with checkboxes and assignees in a group.
telegram_send_checklist
A checklist in a private chat.
telegram_send_poll
A poll or a quiz.
telegram_send_attachment
A file your AI prepared.
send_message
A message to you in your own bot.

The server checks every send: the chat is connected, the bot has the rights, and a retried request never sends twice.

Hosted or self-hosted

Most Telegram MCP servers on GitHub run on your computer and sign in to your Telegram account through MTProto, like a userbot. ChatMate works differently.

ChatMateSelf-hosted on MTProto
Telegram sign-inYour own bot through the official Bot API. No password or login code.api_id and api_hash from my.telegram.org, your phone number and a login code. The saved session opens the whole account.
What the AI seesOnly the chats you connect.Usually every chat in the account.
HistoryFrom the moment a chat is connected, up to 30 days.The full history, channels included.
Where it worksChatGPT and Claude on the web and in their apps, Cursor, Codex and other MCP clients.Apps on your computer that start local servers, while the computer is on.
SetupOne URL and a Telegram sign-in.Python or Node, a config file and a session string to keep secret.
SendingOnly when you ask: as you in private chats, as the bot in groups.As you, in any chat the server allows.

Need old messages or channels? A self-hosted server reads them. ChatMate starts when you connect a chat and does not connect channels.

Limits

  • History starts at connection

    Earlier messages are not available. Messages are kept for up to 30 days.

  • No secret chats or channels

    Telegram gives bots no access to secret chats, and ChatMate does not connect channels.

  • 24 hours to reply in a private chat

    Telegram lets your bot reply in a private chat within 24 hours of the other person’s last message.

  • Never writes on its own

    Your AI sends only when you ask. A message from someone else is data for it, not a command.

Questions about Telegram MCP

What is a Telegram MCP server?

MCP (Model Context Protocol) is an open standard that connects an AI to tools and data. A Telegram MCP server gives ChatGPT, Claude or another AI tools to read Telegram chats and send messages there.

ChatMate is one, hosted for you. It works through your own Telegram bot, so you run nothing and hand over no account. What is ChatMate.

Is ChatMate an official Telegram MCP server?

No. ChatMate is an independent service, not made by Telegram, OpenAI or Anthropic. It works through Telegram’s official Bot API and the open MCP standard.

Do I need api_id, api_hash or a bot token?

No. You create your bot with one button in @chatmate_agent, and your AI signs in with Telegram in the browser. ChatMate never asks for your Telegram password, a login code or tokens.

Can the AI read all my chats?

No. Only the chats you connect: private chats through Secretary Mode, groups where you add the bot. You can turn off a chat or an AI’s access at any time in Profile. How access works.

Does it work in Claude Desktop and Claude Code?

Yes. Add the connector once on claude.ai and it appears in Claude Desktop, the iOS and Android apps and Claude Code with the same account. Claude Code can also add it with one command. Claude Code guide.

How much does it cost?

No ChatMate subscription is on sale yet, and there are no per-action fees. Voice transcription includes 100 minutes a month, up to 20 a day, and minutes bought with Telegram Stars never expire.

Your AI subscription is paid separately to its provider. Pricing.

Plug your chats into your AI.

Works with ChatGPT, Claude and other AIs.

Start in Telegram
QR code that opens @chatmate_agent in Telegram
Open on your phone