Telegram for Claude Code
TSGram - Telegram MCP Server for local Claude Code integration - debug and vibe code on the go!
What is Telegram for Claude Code?
Telegram for Claude Code is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to tsgram - telegram mcp server for local claude code integration - debug and vibe code on the go!
TSGram - Telegram MCP Server for local Claude Code integration - debug and vibe code on the go!
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- TSGram - Telegram MCP Server for local Claude Code integrati
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx tsgramConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Telegram for Claude Code
TSGram is a Telegram-based MCP server that gives developers a remote interface to their local Claude Code environment via Telegram messages. Once configured, your Telegram bot becomes a two-way channel: you can send prompts, view files, get AI code analysis, and receive responses wherever you have Telegram — from your phone, tablet, or another computer. It is particularly useful for developers who want to check on a running Claude Code session or trigger analysis tasks while away from their desk.
Prerequisites
- Node.js 20 or later installed
- Docker Desktop installed and running
- A Telegram account and a bot token from @BotFather
- Your numeric Telegram user ID (from @userinfobot — use the ID, not your username)
- An OpenRouter API key or OpenAI API key for AI analysis
Clone the TSGram repository
Clone the project and navigate into the directory.
git clone https://github.com/areweai/tsgram-mcp.git
cd tsgram-mcpCreate a Telegram bot and get credentials
Open Telegram, message @BotFather with /newbot, follow the prompts, and copy the bot token. Then message @userinfobot to get your numeric user ID for the AUTHORIZED_CHAT_ID variable.
Configure environment variables
Create a .env file in the project root with your Telegram and AI API credentials. Use your numeric user ID for AUTHORIZED_CHAT_ID, not your Telegram username.
TELEGRAM_BOT_TOKEN=your_bot_token_here
AUTHORIZED_CHAT_ID=123456789
OPENROUTER_API_KEY=your_openrouter_key
# OR use OpenAI instead:
# OPENAI_API_KEY=your_openai_keyBuild and start the Docker services
Install Node dependencies, build the Docker image, and start the services. The web dashboard will be available at localhost:3000.
npm install
npm run docker:build
npm run docker:startConfigure your MCP client
Add TSGram to your Claude Desktop or Claude Code MCP config so it can communicate with the running Docker container.
{
"mcpServers": {
"tsgram": {
"command": "npx",
"args": ["tsgram"],
"env": {
"TELEGRAM_BOT_TOKEN": "your_bot_token_here",
"AUTHORIZED_CHAT_ID": "123456789",
"OPENROUTER_API_KEY": "your_openrouter_key"
}
}
}
}Test the Telegram bot
Open Telegram, find your bot by its username, and send a message. You can also use the special commands: ':h ls .' to list the project directory or ':h cat README.md' to read a file. Send 'stop' to pause responses and 'start' to resume.
Telegram for Claude Code Examples
Client configuration
Claude Desktop config for TSGram with all required environment variables.
{
"mcpServers": {
"tsgram": {
"command": "npx",
"args": ["tsgram"],
"env": {
"TELEGRAM_BOT_TOKEN": "your_bot_token_here",
"AUTHORIZED_CHAT_ID": "123456789",
"OPENROUTER_API_KEY": "your_openrouter_key"
}
}
}
}Prompts to try
Messages you can send to your TSGram Telegram bot or use via the MCP client.
- "What files are in my project root? (:h ls .)"
- "Show me the contents of src/index.ts (:h cat src/index.ts)"
- "Analyze the last error in the logs and suggest a fix."
- "Check if the server is healthy (npm run docker:health)."
- "Stop responding to new messages for now. (stop)"Troubleshooting Telegram for Claude Code
Bot does not respond to Telegram messages
Confirm the Docker containers are running with 'npm run docker:logs'. Check that TELEGRAM_BOT_TOKEN is correct and that AUTHORIZED_CHAT_ID matches your numeric user ID (not username). Use @userinfobot to get the correct ID.
Docker build fails with permission or port errors
Ensure Docker Desktop is running before executing 'npm run docker:build'. If port 3000 is already in use, stop the conflicting service or change the port mapping in docker-compose.yml.
AI analysis responses are not returned
Verify that OPENROUTER_API_KEY or OPENAI_API_KEY is set and valid. Check 'npm run docker:logs' for API authentication errors. Only one of the two keys is needed — set whichever you have.
Frequently Asked Questions about Telegram for Claude Code
What is Telegram for Claude Code?
Telegram for Claude Code is a Model Context Protocol (MCP) server that tsgram - telegram mcp server for local claude code integration - debug and vibe code on the go! It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Telegram for Claude Code?
Follow the installation instructions on the Telegram for Claude Code GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Telegram for Claude Code?
Telegram for Claude Code works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Telegram for Claude Code free to use?
Yes, Telegram for Claude Code is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Telegram for Claude Code Alternatives — Similar Communication Servers
Looking for alternatives to Telegram for Claude Code? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Telegram for Claude Code in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Telegram for Claude Code?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.