telegram-claude-mcp
Allows to send messages and ask questions via Telegram, enabling communication with a user through the Telegram Bot API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@telegram-claude-mcp ask me if I want to proceed with the database migration"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Telegram MCP Bridge
An MCP server that lets Claude Code send messages and ask questions via Telegram.
When Claude Code needs your input during a coding task, it sends a Telegram message (with optional inline buttons) and waits for your reply.
Claude Code → MCP tool call → this server → Telegram Bot API → your phone
← tool result ← server ← you tap a button / type a replyTools
Tool | Description |
| Send a question with optional buttons, wait for response (10-min timeout) |
| Fire-and-forget notification |
Related MCP server: Telegram Notification MCP Server
Setup
1. Create a Telegram Bot
Open Telegram, message @BotFather
Send
/newbot, follow prompts — save the bot tokenMessage your new bot (send anything), then visit:
https://api.telegram.org/bot<YOUR_TOKEN>/getUpdatesFind your chat ID in the response JSON (
result[0].message.chat.id)
2. Clone & Install
git clone https://github.com/yourusername/telegram-claude-mcp.git
cd telegram-claude-mcp
npm install3. Configure Claude Code
Add to ~/.claude/mcp.json (create the file if it doesn't exist):
{
"mcpServers": {
"telegram": {
"command": "node",
"args": ["/absolute/path/to/telegram-claude-mcp/telegram-bridge.js"],
"env": {
"TELEGRAM_BOT_TOKEN": "your-bot-token",
"TELEGRAM_CHAT_ID": "your-chat-id"
}
}
}
}4. Restart Claude Code
The MCP server starts automatically when Claude Code launches. You should see telegram in your MCP server list.
Usage
Claude Code will automatically have access to ask_user and notify_user tools. You can prompt it to use them:
"If you need to ask me something, use the ask_user Telegram tool"
Or Claude may use them when configured in your project's CLAUDE.md.
License
MIT
Available Tools
2 toolsask_userA
Send a question to the user via Telegram and wait for their response. Optionally include inline buttons for quick replies. Times out after 10 minutes.
Inputs: message (required), buttons.
notify_userA
Send a notification message to the user via Telegram. Does not wait for a response.
Inputs: message (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools are clearly separated by whether they wait for a reply: ask_user requires an answer, notify_user is fire-and-forget. There is no overlap in their intended use.
Both tools follow the same verb_object pattern (ask_user, notify_user), making their behavior predictable and consistent.
With only two tools, the set feels minimal. While it covers the basic interaction modes, two tools is at the lower boundary of what is considered a well-scoped set.
The server covers the two fundamental Telegram interaction patterns (interactive question and one-way notification). Some advanced messaging features like media or message editing are absent, but for the stated purpose the core functions are present.
Maintenance
Related MCP Connectors
Hosted Telegram MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Let AI assistants post to your Telegram chats, groups and channels. Not affiliated with Telegram.
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
Free WhatsApp MCP server for ChatGPT and Claude: read and search chats, every send you approve.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA simple MCP server that allows Claude to access your Telegram account to read and send messages on your behalf.7Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables Claude Code to send Telegram notifications when tasks complete, errors occur, or user intervention is needed. Runs serverless on Cloudflare Workers with support for formatted messages and flexible chat targeting.266 npm22MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that sends and receives Telegram messages to a fixed contact, and triggers claude.ai routines for automatic replies.-
- FlicenseNot gradedqualityDmaintenanceMCP server that connects Claude to a Telegram personal assistant, enabling message processing, task management, and responses via scheduled workflows.-