Files

RichardDillman 6c8c9350a1 feat: Claude Telegram Bridge MCP server

A Model Context Protocol (MCP) server that enables Claude to communicate
with users via Telegram. Provides two-way communication, notifications,
question/answer flows, and message queuing.

Features:
- MCP server implementation with 5 tools
- HTTP bridge for Telegram Bot API
- Real-time notifications with priority levels
- Question/answer blocking flow
- Message queue for async communication
- Background daemon support

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-11-23 00:55:30 -05:00

1.9 KiB

Raw Blame History

Installation Guide

Quick reference for setting up the Claude Telegram Bridge MCP server.

Prerequisites

Node.js 18+ installed
pnpm installed (npm install -g pnpm)
Telegram account

Step-by-Step Setup

1. Get Your Telegram Bot Token

Open Telegram and search for @BotFather
Send: /newbot
Name your bot (e.g., "My Claude Bridge")
Choose username (e.g., "my_claude_bridge_bot")
Save the token BotFather gives you

2. Install the Bridge

# Clone/download this repo
cd claude-telegram-bridge

# Install dependencies
pnpm install

# Create environment file
cp .env.example .env

# Edit .env and add your bot token
# TELEGRAM_BOT_TOKEN=paste_your_token_here

3. Build and Start

# Build
pnpm build

# Start (choose one)
pnpm dev          # Foreground
pnpm daemon       # Background (requires pm2)

4. Initialize Bot

Open Telegram
Find your bot
Send: /start
Bot saves your chat ID automatically

5. Configure Claude MCP

Edit ~/.config/claude-code/settings/mcp.json:

{
  "mcpServers": {
    "telegram": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/claude-telegram-bridge/dist/mcp-server.js"
      ],
      "env": {
        "TELEGRAM_BRIDGE_URL": "http://localhost:3456"
      }
    }
  }
}

Find your path with: cd claude-telegram-bridge && pwd

6. Test

Restart Claude Code and say:

"Send me a test notification via Telegram"

You should receive a message in Telegram!

Troubleshooting

Bridge not running?

curl http://localhost:3456/health

MCP server not found?

Check the absolute path in your MCP config
Make sure you ran pnpm build

No Telegram messages?

Did you send /start to your bot?
Check bridge logs: pnpm logs (if using daemon)

Next Steps

See README.md for full documentation and usage examples.

1.9 KiB Raw Blame History