areweai/tsgram-mcp
FreeTSgram: Telegram + Claude with local workspace access on your phone in typescript. Read, write, and vibe code on the go!
FreeFree tier
Inputs: textOutputs: text
About areweai/tsgram-mcp
TSGram MCP is an open-source MCP server that connects Claude Code sessions to Telegram. It runs locally using Docker and Node.js, enabling developers to interact with their Claude Code project via Telegram – asking questions about the codebase, getting AI insights, and editing files from their phone. All processing stays local for privacy. Includes a local web dashboard for managing bots and supports both Claude Code and Claude Desktop integration.
Key Features
Local Docker container runs the Telegram webhook server
TSGram MCP server runs locally and connects to Claude Code sessions
Create and delete Telegram bots in-app, restricted to your user ID
Modern local web dashboard to manage bots
Ask questions about your codebase, get AI insights, and edit files from Telegram
Supports both Claude Code (CLI) and Claude Desktop integration
Setup takes about 3 minutes with Docker and Node.js
Pros & Cons
Pros
- All processing stays on your local machine, ensuring data privacy and security
- Quick and straightforward setup with Docker and Node.js (under 3 minutes)
- Direct integration with both Claude Code and Claude Desktop
- Accessible from any mobile device via Telegram without needing a dedicated app
- Open-source and free to use
- Includes a local web dashboard for bot management
Cons
- Requires Docker Desktop and Node.js 20+ to be installed locally
- Bots only function while your computer is online and running the Docker containers
- Limited to Telegram as the interface; no other messaging platforms supported
- Setup requires manually creating a Telegram bot via @BotFather and obtaining credentials
Best For
AI-powered code assistance on the go via Telegram from your phoneRemote codebase querying and light editing while away from your computerIntegrating Claude Code with Telegram for collaborative debugging or 'vibe coding'Managing multiple Claude Code sessions through a single Telegram bot
FAQ
How does TSGram work?
TSGram runs a local Docker container that hosts a Telegram webhook server. The TSGram MCP server connects to Claude Code locally, allowing you to send Telegram messages that are processed by Claude and replied to directly in your Telegram chat.
Is my code safe?
Yes, all processing is local. Your code never leaves your machine; the Telegram bot only acts as an interface between you and the locally running Claude Code session.
What do I need to run TSGram?
You need Docker Desktop and Node.js 20+ installed. You also need a Telegram bot token from @BotFather and your Telegram user ID from @userinfobot.
Can I run TSGram with Claude Desktop?
Yes, TSGram supports both Claude Code (CLI) and Claude Desktop. The setup involves adding the MCP server configuration to your Claude Desktop configuration file.