areweai/tsgram-mcp

TSGram MCP 🚀

Get Claude Code in your local project talking to Telegram in 3 minutes!

TSGram MCP connects Claude Code sessions to Telegram using TS/Node/Docker/cli-utils, enabling AI-powered code assistance directly in your Telegram chats. Ask questions about your codebase, get AI insights, and even edit files - all from Telegram on your phone!

🔒 How It Works (All Local)

• Local Docker container runs the Telegram webhook server
• TSGram MCP server runs locally
• Your Claude Code or Claude Desktop runs locally and adds MCP locally
• Create and delete bots in-app through Telegram, access limited to your telegram user id
• Modern local web dashboard to manage bots from localhost
• Local means local! If your computer is offline, so are your bots.

Quick Start (3 Minutes)

🤖 AI Agent Enhanced Setup (Recommended!)

Let Claude handle the entire setup and ask you for the required values.

From your terminal: 0. Install Docker Desktop and Node.js 20+ (npm included)

1. Clone the repository:

   git clone https://github.com/areweai/tsgram-mcp.git
   cd tsgram-mcp
   

2. From the command line, start Claude:

   claude --model sonnet
   

3. Initialize with /init

4. Copy and paste this prompt:

   First, explain to the human how to register a new Telegram bot with @BotFather and get their bot token (TELEGRAM_BOT_TOKEN), and how to get their Telegram user ID from @userinfobot (for AUTHORIZED_CHAT_ID). They can work on getting these credentials while you set up the system. Then help the user set up tsgram-mcp for claude code. Do everything from installing node modules to creating and deploying the local docker containers. Finally, when everything is deployed, remind the user to configure their bot token and authorized chat ID along wither other required .env variables.