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.
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.
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:
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.
04
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.
ChatMate
Self-hosted on MTProto
Telegram sign-in
Your 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 sees
Only the chats you connect.
Usually every chat in the account.
History
From the moment a chat is connected, up to 30 days.
The full history, channels included.
Where it works
ChatGPT 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.
Setup
One URL and a Telegram sign-in.
Python or Node, a config file and a session string to keep secret.
Sending
Only 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.
05
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.
06
Questions about Telegram MCP
01What 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.
02Is 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.
03Do 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.
04Can 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.
05Does 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.
06How 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.