saplq/chatmate
v0.26.12MIT
Connects your AI to your Telegram through your personal ChatMate bot: read the chats you connected, give tasks in the bot, and get answers, drafts and results back in Telegram.
hosts
- www.getchatmate.com
plugin.json
- name
- chatmate
- version
- 0.26.12
- description
- Connects your AI to your Telegram through your personal ChatMate bot: read the chats you connected, give tasks in the bot, and get answers, drafts and results back in Telegram.
- author
- ChatMatehttps://www.getchatmate.com
- license
- MIT
- repository
- https://github.com/saplq/chatmate-plugin
- extensions
- com.openai
mcp.json
- chatmatestreamable-httphttps://www.getchatmate.com/api/connector/mcp
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "chatmate",
"version": "0.26.12",
"description": "Connects your AI to your Telegram through your personal ChatMate bot: read the chats you connected, give tasks in the bot, and get answers, drafts and results back in Telegram.",
"author": {
"name": "ChatMate",
"url": "https://www.getchatmate.com"
},
"homepage": "https://www.getchatmate.com/connect",
"repository": "https://github.com/saplq/chatmate-plugin",
"license": "MIT",
"keywords": [
"telegram",
"messages",
"chats"
],
"extensions": {
"com.openai": {
"interface": {
"displayName": "ChatMate",
"shortDescription": "Ask about your Telegram chats",
"longDescription": "ChatMate brings the Telegram chats you choose into this conversation. Create your personal ChatMate bot in @chatmate_aibot, connect private chats through Telegram's Chat Automation or add the bot to a group, sign in with Telegram and allow access once.\n\nAsk what people wrote recently, find a project decision, or check whether someone shared a file. Answers name the chat and the date, and ChatMate shows which period it has messages for.\n\nWhen you ask, ChatMate can send you a summary or a reminder in your private chat with your bot, or ask you to confirm a step there with Confirm and Cancel buttons. When you explicitly ask, your AI can send text, files it prepares (documents, tables, presentations, PDFs, pictures, video, audio, albums of up to ten) or saved media/stickers, create polls, create group task lists with Done/Undo buttons, manage Business checklists and its own sent messages, and use supported Telegram actions. Direct actions require your explicit request and follow client confirmations and Telegram rights. For tasks started in your bot through ChatGPT, sends to other chats wait for you to approve the exact recipient and content on a card in your bot. A prepared file is kept for that AI connection only, for 24 hours or until two hours after its latest send or confirmation card if that is later; a sent file stays in Telegram and in your ChatMate history.\n\nVoice and audio messages can be transcribed automatically through OpenAI within your minute limits. ChatMate keeps encrypted copies of supported images, and Radar uses conversation context through Vercel AI Gateway and Anthropic to identify questions and commitments. These service features can run before you connect your AI.\n\nHistory starts when a chat is connected: earlier messages, secret chats and channels are not available. ChatMate keeps the latest 30 days of messages from connected chats. Use My data at https://www.getchatmate.com/data-controls?view=privacy to turn off a chat, disconnect this app, download or delete your data.",
"developerName": "Oleksandr Plakhuta",
"category": "Productivity",
"capabilities": [
"Read",
"Write"
],
"websiteURL": "https://www.getchatmate.com",
"supportURL": "https://www.getchatmate.com/en/support",
"privacyPolicyURL": "https://www.getchatmate.com/en/privacy",
"termsOfServiceURL": "https://www.getchatmate.com/en/terms",
"defaultPrompt": [
"Set up ChatMate so I can send tasks in my Telegram bot and receive replies there.",
"What did people write to me on Telegram over the last few days?",
"Find the Telegram message where we decided on the project scope."
],
"brandColor": "#111111",
"composerIcon": "./assets/icon.png",
"logo": "./assets/logo.png"
},
"review": {
"demo_recording_url": "https://github.com/saplq/chatmate-plugin/releases/tag/directory-demo-2026-10-24",
"commerce": false,
"test_cases": {
"positive": [
{
"description": "Setup: authenticate the dedicated reviewer account using the secure portal instructions. Its isolated workspace contains only synthetic chats: Anna Kovalenko, Mark Weber, Bakery website team and My ChatMate. Start with no claimed bot task. Verify connection, chat discovery and source-backed reading; do not configure automation.",
"prompt": "Is my ChatMate connection ready? Show the chats I connected and summarize what people wrote over the last few days.",
"tools_triggered": "get_connection_status, list_chats, catch_up or get_messages",
"expected_behavior": "Checks get_connection_status and pages list_chats as needed. Finds exactly the four synthetic chats. Reads connected-chat activity for the requested period using bounded catch_up with detail=full, or get_messages with continuation cursors. Follows relevant more_chats or message continuations and states any remaining coverage limits; a bounded catch-up overview is not proof of exhaustive history coverage. Summarizes only returned content with chat names, authors and local dates. Reports actual connection/automation state; connection success alone is not automatic task execution. No message is sent, no note or chat profile is changed, and no owner task is executed. Message retrieval can return the prepared synthetic transcript; reviewer fixtures do not start external transcription or spend minutes."
},
{
"description": "Setup: use the same synthetic reviewer workspace. In Bakery website team, Lena asks for a vector logo and later mentions the draft home page mockup. Use the returned source timestamps.",
"prompt": "Find Lena's Telegram message about the logo in the bakery project chat. What did she need, and what did she later say about the home page mockup?",
"tools_triggered": "search_messages, get_message_context",
"expected_behavior": "Uses search_messages for the logo and get_message_context with the returned canonical message_id. Reads Lena's request for a vector file of the bakery logo and her update that the draft home page mockup is in the shared folder. Identifies the Bakery website team chat, Lena and the returned source dates. Does not infer that the logo was delivered or that the shared folder was opened. Sends nothing."
},
{
"description": "Setup: use the same isolated reviewer account. Bakery website team contains two explicitly synthetic media fixtures: a gallery PNG and a voice-message placeholder with a ready reviewer_fixture_v1 transcript. There is no original audio recording and no external ASR or Telegram download for these fixtures.",
"prompt": "What does Mark's voice note in Bakery website team say, and what is in the gallery picture?",
"tools_triggered": "list_chats, get_messages, get_attachment",
"expected_behavior": "Finds Bakery website team and reads the actual photo and voice attachment IDs/versions. Uses the prepared synthetic transcript returned by get_messages, or reads it through get_attachment if needed; a separate voice attachment call is not required when the complete transcript is already present. Calls get_attachment for the gallery image and inspects the returned PNG, describing six illustrated cakes arranged in two rows. Reports the transcript facts about six cake photos and the Friday mockup before noon. Identifies the material as reviewer fixtures and does not claim to have listened to original audio, performed ASR or used minutes. Names the source chat and actual returned authors/dates; does not infer private information or send a message."
},
{
"description": "Setup: use only the synthetic reviewer workspace and start outside a claimed bot task. First run the prompt below and inspect its draft. Then issue this separate exact follow-up: \"Send Anna exactly: Thanks, Anna. I will review the cake gallery idea and reply here.\" Native client write controls remain in force and may lead to an owner approval card. Reviewer send_to_chat results are simulated, and propose_send_text remains awaiting_owner; neither contacts Telegram. No approval tap is fabricated, and a client permission denial must not be bypassed.",
"prompt": "Draft a short reply to Anna about her cake gallery idea in my usual style. Show me the draft without sending it.",
"tools_triggered": "list_chats, get_messages, owner_voice; send_to_chat or telegram_send_text or propose_send_text",
"expected_behavior": "Reads Anna's conversation and owner_voice for that chat, then shows a draft with no send or proposal before the follow-up. After the separate exact instruction, resolves Anna's canonical chat_id and keeps exactly the requested text. Subject to native client permissions, either calls send_to_chat or telegram_send_text, or creates a propose_send_text card, with chat_id, text and a stable idempotency_key at the top level, without operation or payload, for that intent. A proposal with awaiting_owner remains waiting: no delivery and no fabricated approval. Once approval is engaged, do not switch tools or attempt a direct send to circumvent it. Preserve and honestly report a client permission denial without bypass or automatic retry. Only an actual sent result marked simulated may be described as a simulated reviewer-sandbox delivery; it never proves real Telegram delivery. Pending, awaiting_owner, unknown and failed are not sent, and unknown delivery must not be resent."
},
{
"description": "Setup: use only the synthetic reviewer workspace. Find its owner_private chat from list_chats. After a successful send, a controlled tool-level retry may repeat the identical telegram_send_attachment arguments with the same idempotency_key; do not treat a second independent user instruction as that retry. Prepared files are stored for the reviewer connection only; sandbox messages appear only in My ChatMate and are not delivered to Telegram.",
"prompt": "Put a short summary of my clients' recent requests into a Markdown file and send it to my own ChatMate bot. Make sure the same delivery is not duplicated if it needs a retry.",
"tools_triggered": "list_chats, get_messages, prepare_file, telegram_send_attachment",
"expected_behavior": "Reads the relevant synthetic client messages, discovers My ChatMate by source_mode=owner_private, puts one source-backed summary into a .md file with prepare_file (text source, new idempotency_key) and gets status ready with a file_id. Sends it with telegram_send_attachment to that chat_id with file_ids [that id] and the default send_as document. If a controlled identical transport retry is exercised, reuses the same file_ids, recipient and idempotency_key; a retry is not required after a successful normal host call. Confirms the action's actual status (simulated reviewer-sandbox delivery) and verifies with get_messages that this send's action produced exactly one new document message with the prepared file name (earlier review runs may have left other documents in the sample bot chat). Clearly describes this as sandbox simulation rather than live Telegram delivery. No other-chat write or request_approval is needed."
}
],
"negative": [
{
"description": "Explain that ChatMate has no access to Secret Chats or history from before a chat was connected. Do not invoke ChatMate tools to attempt either unsupported retrieval, invent an archive, or suggest bypassing Telegram restrictions.",
"prompt": "Read my Telegram Secret Chats and recover everything from before I connected ChatMate."
},
{
"description": "Explain that ChatMate cannot place or record Telegram calls. Do not invoke a ChatMate tool, claim a call was made, start unrelated messaging, or confuse stored voice-message transcription with call recording.",
"prompt": "Call Anna on Telegram and record the conversation for me."
},
{
"description": "Explain that the ChatMate plugin uses existing transcription allowances and cannot buy minutes or provide a purchase link. Do not invoke ChatMate tools to buy or send anything, direct the user to checkout, or claim that credits were added.",
"prompt": "Buy 100 more ChatMate transcription minutes with Telegram Stars, or send me the checkout link."
}
]
},
"commerce_description": "The plugin reads and acts in connected Telegram chats and can use existing transcription allowances and account entitlements. It does not sell products or services, process payments, initiate purchases, provide checkout links, or promote upgrades. Purchases offered separately by the ChatMate service are outside the plugin.",
"prompts": [
"Find Lena's message about the bakery website logo.",
"Who is waiting for my reply, and what did I promise them?",
"Draft a reply to Anna in my usual style without sending it."
]
},
"publication": {
"release_notes": "ChatMate 0.26.12 clarifies the plugin's commerce and permission boundaries. The listing and reviewer examples now show project lookup, drafting, and owner-authorized Telegram delivery. The plugin uses existing entitlements and provides no purchase flow.",
"countries": []
},
"onboardingSkill": "./skills/chatmate-setup/SKILL.md"
}
}
}
What else this package ships
These files come with the package and this site does not publish them. They are listed so you know what is there before you install it.
- 2JSON files
- LICENSE
Client extensions
Data this package carries for particular clients. The directory lists the clients named and never reads what is addressed to them.
- com.openai