Setup

From Telegram to your AI’s answer.

ChatMate is a hosted Telegram MCP connector for your own AI. Connect selected private chats and groups through your personal bot, without a server or API keys. Replies directly in the bot are an optional extra.

ChatMate is free for now. Your AI subscription is separate.

Three things to check before you start

What you want to doChatGPTClaude
Read connected chatsConnect ChatMate through a plugin or custom MCP connection available to your account.Add the ChatMate custom connector and allow access to your connected chats.
Start a task from TelegramSeparately configure supported Work Events. Connecting chats alone does not turn on replies in your bot.Separately configure a cloud task (formerly Routine) with an API trigger and a supported paid plan.
Return a result or act in TelegramRequires the sending tools and permissions available in your client. Returning an answer to you and sending to another chat are separate actions.Requires the tools and permissions enabled in the client or cloud task. Confirmation prompts depend on that environment’s settings.

First check an answer against a new source message. If you also want tasks from Telegram, test that separately: the trigger is ready after the automatic answer arrives in your bot and the connection check succeeds.

Set up tasks from Telegram

Three setup milestones

  1. @chatmate_agent

    01. Create your bot

    Open @chatmate_agent, pick an avatar with the arrows and tap Create bot. You can change the name and photo later.

    When the bot is ready, you get an Open my bot button. From there it guides you step by step.

    You delete the bot in the same place, @chatmate_agent.

    A chat with the ChatMate bot in Telegram. Alex sends /start, the bot shows the card Create your own ChatMate with an avatar, arrows and a Create bot button. Then the card Your personal ChatMate arrives: My mate, @alex_mate_bot, Your bot is ready. Open it, with an Open my bot button.

    Details for this step

    Your bot

    Allow message storage

    The bot starts with Step 1 of 3. ChatMate keeps new messages from connected chats for up to 30 days and does not import old history.

    The ChatMate server can read messages. Recognized passwords and codes are masked before storage. You can turn off a chat and delete your data at any time.

  2. Telegram settings

    02. Connect private chats

    Copy the bot username. In Telegram open Settings → Edit profile → Chat Automation and paste it.

    Pick the chats your AI will see. Telegram Premium is not required.

    Secret chats and channels can’t be connected. History starts when you connect.

    Telegram’s Chat Automation screen: Alex enters @alex_mate_bot, chooses Only selected and adds the chats Mila and Taras.

    Details for this step

    BotFatherIf the bot asks

    Turn on Secretary Mode

    Without this mode Telegram won’t list the bot in Chat Automation. If it is already on, the bot goes straight to chats.

    Open BotFather, choose your bot, then Bot Settings → Secretary Mode. Go back to the bot and tap Check.

    A Telegram group

    Add groups

    Add the bot to a group as an admin. It sends you a Group discovered card, tap Connect.

    The bot doesn’t need to delete messages or ban members. If you’re not an admin, the bot drafts a request for one.

  3. Your AI

    03. Connect your AI

    In your browser open chatgpt.com/plugins → + → Add custom MCP server. Enter ChatMate, the supplied Server URL and OAuth, then Create as a plugin, Install and Connect.

    A ChatMate page opens. Log in with Telegram and click Allow. Then go back to the bot and tap Check.

    Your AI sees every chat connected to your bot, including ones you add later.

    A browser window. In ChatGPT, Alex adds a custom MCP server through Plugins with its Server URL and OAuth, then Install and Connect (in Claude, adds a custom connector). ChatMate opens: Telegram login and the page ChatGPT wants access. After Allow, ChatMate shows as connected.

    Details for this step

    Chat with your AI

    Try one new message

    Use one new message in a connected chat, or create one in a separate test chat. In your AI app, ask: “What did they ask me to do in [chat name]? Show the source message and anything I need to clarify.”

    Find the original in Telegram and compare the chat, author, time and text with the answer. Earlier history is not imported. To receive the result in Telegram, set up tasks from your bot separately and run the reply check below.

Step by step for your AI.

Choose your AI: ChatGPT, Claude, Muse, Grok Bot or a coding tool. Each guide covers its setup, example requests and what works with Telegram.

AIWhere to add itWrites to Telegram
Claudeclaude.ai or Claude Desktop, by URLAccording to the selected tool permissions
ChatGPTchatgpt.com › Plugins, by URLWith available tools and client permissions
Claude Codeclaude mcp add, or your claude.ai connectorYes, after permission
CodexFrom ChatGPT, or codex mcp addYes; set approval to writes
CursorOne click or mcp.jsonYes, after Run tool
Grok BotAsk Grok Bot to add ChatMate, then sign inOn your request; Bot permissions apply
Grokgrok.com › Connectors, by URLYes, after Allow
MuseAsk Muse in a chatYes, after Allow
Another AIPerplexity, Devin, VS Code and more, by URLDepends on the client
Optional · Tasks from the bot

You can give tasks to your bot. Set up and test the trigger first.

Once connected, you can ask questions in your AI. For your AI to pick up a task from the bot and answer there, set up supported ChatGPT Work Events or a Claude cloud task (formerly Routine) with an API trigger.

01ChatGPT WorkEvents

Open Work on the web and send the setup request. Your AI configures events if your ChatGPT account supports Events.

02Claude cloud taskFormerly Routine

Requires a supported paid Claude plan with cloud tasks enabled. Add an API trigger, then save its URL and token on the protected ChatMate setup page. Never paste the token into a chat.

03Check

Send the bot: “Find the new request in [chat name], summarize the next step and return the answer here. Don’t message anyone else.” Wait for the automatic reply, then tap Check. A connected account alone does not pass this test.

In your personal bot, open MCP connectors → Set up AI replies. Choose ChatGPT or Claude to find the setup request and cloud-task form (Routine in some screens).

  • One AI picks up tasks from the bot. If it doesn’t answer, a second one won’t step in.
  • Schedules depend on what your AI supports and are set up separately.
Help

If something is off, start here.

  1. 01The AI doesn’t see a private chat

    Check that the chat is selected in Chat Automation. A chat appears with its first new message, and your main circle usually comes together in 3–7 days. Messages from before you connected won’t appear.

  2. 02A group didn’t connect

    The bot needs admin rights. If you’re not an admin, tap Ask an administrator in the bot and forward the request.

  3. 03A new chat is missing in an older connection

    Older AI connections only see the chats that were connected when you allowed access. Open MCP connectors in your personal bot’s menu and reconnect your AI.

  4. 04A task in the bot got no reply

    Connecting your AI is not enough for it to answer in the bot on its own. Check whether the account supports Work Events or a Claude cloud task with an API trigger. Configure that trigger and test with a short task.

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