Overview
Telegram MCP Server is a Model Context Protocol (MCP) server that allows large language models (LLMs) to send notifications via Telegram and receive user responses.
To use the Telegram MCP Server, you need to install it via npm or clone it from GitHub, set up your Telegram bot token and chat ID, and run the server with the appropriate environment variables.
- Send text notifications to a Telegram chat with customizable urgency levels. - Wait for and retrieve user responses. - Integrates with Cline and other MCP-compatible LLM applications.
- Sending alerts or notifications from applications to users on Telegram.
- Receiving user feedback or responses through Telegram.
- Integrating with other LLM applications for enhanced communication.
Add to your AI client
Use these steps to connect Telegram MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"telegram-mcp-mobilevibe": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-telegram-mcp-mobilevibe"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"telegram-mcp-mobilevibe": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-telegram-mcp-mobilevibe"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"telegram-mcp-mobilevibe": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-telegram-mcp-mobilevibe"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"telegram-mcp-mobilevibe": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-telegram-mcp-mobilevibe"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"telegram-mcp-mobilevibe": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-telegram-mcp-mobilevibe"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"telegram-mcp-mobilevibe": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-telegram-mcp-mobilevibe"
]
}
}
}FAQ
How do I get a Telegram bot token?
You can obtain a Telegram bot token by chatting with @BotFather on Telegram and following the instructions to create a new bot.
Can I use this server for any Telegram bot?
Yes, as long as you have the bot token and chat ID, you can use this server for any Telegram bot.
Is there any cost associated with using the Telegram MCP Server?
No, the Telegram MCP Server is open-source and free to use.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":2475,"uuid":"e54f1705-7e35-4320-9c47-241af14e2e31","name":"telegram-mcp","title":"Telegram MCP Server","description":"MCP server to send notifications to Telegram","avatar_url":"https://avatars.githubusercontent.com/u/202861600?v=4","created_at":"2025-03-13T08:12:37.253Z","updated_at":"2025-03-13T13:53:50.023Z","status":"created","author_name":"MobileVibe","author_avatar_url":"https://avatars.githubusercontent.com/u/202861600?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/MobileVibe/telegram-mcp","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"0\",\"license\":\"MIT license\",\"language\":\"JavaScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-21 09:23:47\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]