Telegram MCP Server
Remote control AI coding assistants (Claude Code / Codex) via Telegram
English |
Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดHave you ever encountered these scenarios:
Telegram MCP Server was created to solve these problems!
Through the MCP (Model Context Protocol), this project allows you to:
screen on remote servers to manage multiple projects simultaneouslyPerfect for:
# Use uvx (recommended, no installation needed, always latest version)
uvx --refresh telegram-mcp-server@latest --setup
This will:
That's it! 🎉
# Check version (should be 0.2.1 or higher)
uvx telegram-mcp-server@latest --version
Expected output:
telegram-mcp-server version 0.2.1
https://github.com/batianVolyc/telegram-mcp-server
# Always use latest version
uvx telegram-mcp-server@latest --setup
# Or using pip
pip install telegram-mcp-server
telegram-mcp-server --setup
Interactive wizard will help you:
mcp addIf you already have your Telegram Bot Token and Chat ID, you can quickly add using the mcp add command:
Claude Code:
claude mcp add \
--transport stdio \
telegram \
--env TELEGRAM_BOT_TOKEN=YOUR_TOKEN_HERE \
--env TELEGRAM_CHAT_ID=YOUR_CHAT_ID_HERE \
-- \
uvx telegram-mcp-server
Codex:
codex mcp add telegram \
--env TELEGRAM_BOT_TOKEN=YOUR_TOKEN_HERE \
--env TELEGRAM_CHAT_ID=YOUR_CHAT_ID_HERE \
-- \
npx -y telegram-mcp-server
Gemini CLI:
gemini mcp add telegram uvx telegram-mcp-server \
-e TELEGRAM_BOT_TOKEN=YOUR_TOKEN_HERE \
-e TELEGRAM_CHAT_ID=YOUR_CHAT_ID_HERE
💡 Tip: Replace
YOUR_TOKEN_HEREandYOUR_CHAT_ID_HEREwith your actual values
# Recommended: Start with bypass permissions mode
# Avoid interruptions due to permission confirmations during AI-Telegram interaction
# Note: Cannot run as root due to security mechanisms
# Claude Code
claude --permission-mode bypassPermissions
# Codex
codex --dangerously-bypass-approvals-and-sandbox
# Gemini CLI (YOLO mode - auto-approve all MCP calls)
gemini --yolo
# In the AI assistant
> Enter unattended mode. Task: analyze project structure
Check results in Telegram and continue the conversation!
AI Assistant (Claude Code/Codex)
↓ MCP Protocol
MCP Server (telegram-mcp-server)
├─ 8 tools (notify, wait, file operations, etc.)
└─ Telegram Bot (background process)
↓ Telegram API
Your Telegram Client
telegram_notify - Send structured notifications (recommended)telegram_wait_reply - Wait for user reply (blocking poll)telegram_unattended_mode - Unattended mode (smart loop)telegram_send_code - Send code (with syntax highlighting)telegram_send_image - Send imagestelegram_send_file - Send filestelegram_send - Send free-form messagestelegram_get_context_info - Get session context info/sessions - List all sessions/status <id> - Check session status/to <id> <msg> - Send message to session/file <id> <path> - View file/delete <id> - Delete session/help - Show helpProgressive polling strategy, wait up to 7 days:
# 10 PM
> Enter unattended mode. Task: run full test suite and fix all errors
# 8 AM - check results in Telegram
# At office
> Enter unattended mode. Task: refactor database access layer
# On the road - monitor and control via Telegram
# SSH to remote server
ssh user@server
# Create multiple screen sessions
screen -S project-a
cd /path/to/project-a
TELEGRAM_SESSION="proj-a" claude --permission-mode bypassPermissions
# Ctrl+A D to detach
screen -S project-b
cd /path/to/project-b
TELEGRAM_SESSION="proj-b" codex --dangerously-bypass-approvals-and-sandbox
# Ctrl+A D to detach
# Manage both projects in Telegram
# Sessions keep running even after closing SSH
# During the day, start session on server
screen -S night-task
TELEGRAM_SESSION="night-fix" claude --permission-mode bypassPermissions
# At night in bed, send commands via Telegram
/to night-fix Fix null pointer exception in auth.py
# Next morning, check results
/status night-fix
Supports three configuration scopes:
MCP Server Configuration:
~/.claude.json - Global config.mcp.json - Team shared.claude.json - Project specificEnvironment Variables (auto-configured):
~/.claude/settings.json - Contains MCP_TOOL_TIMEOUT=604800000 (7-day timeout)Global config: ~/.codex/config.toml
Auto-includes tool_timeout_sec = 604800 (7 days timeout)
# Custom session name
TELEGRAM_SESSION="my-task" claude
# Custom max wait time
TELEGRAM_MAX_WAIT=86400 claude # 24 hours
# Custom poll intervals
TELEGRAM_POLL_INTERVAL="10,30,60" claude
# Check logs
tail -f /tmp/telegram-mcp-server.log
# Quick fix
cd telegram-mcp-server
./quick_fix.sh
# Auto fix
./fix_codex_timeout.sh
# Reconfigure
telegram-mcp-server --setup
Contributions welcome! See CONTRIBUTING.md
MIT License - see LICENSE
Let AI coding assistants work for you, not you waiting for them 🚀
Remote control AI coding assistants (Claude Code/Codex) via Telegram
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Telegram ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-28 Remote control AI coding assistants (Claude Code/Codex) via Telegram