</>MCP Agents Market
Plugin

claude-code-telegram

by RichardAtCT2.8kPythonUpdated 2026-03-30

A powerful Telegram bot that provides remote access to Claude Code, enabling developers to interact with their projects from anywhere with full AI assistance and session persistence.

Claude Code

claude-code-telegram is a Telegram bot plugin that provides remote access to Claude Code, enabling developers to interact with their codebase through conversational AI from any device running Telegram. The bot maintains session persistence across conversations and offers two modes: an agentic mode for natural language interaction and a classic terminal-like mode with structured commands. It supports file uploads, voice transcription, webhook-driven automation, scheduled jobs, and built-in security features including user authentication, directory sandboxing, and audit logging.

Key Features

Conversational agentic mode with natural language code analysis, editing, and explanation without terminal commands
Automatic session persistence per user and project directory to maintain context across conversations
Real-time verbosity controls showing Claude's tool usage and reasoning as it works (quiet, normal, or detailed)
Voice message transcription support using Mistral Voxtral, OpenAI Whisper, or local whisper.cpp
Event-driven automation with webhook API server for GitHub events and cron-based job scheduler
Multi-layer security with user whitelisting, directory sandboxing, path traversal protection, and audit logging
Classic mode with 13 commands including directory navigation, git integration, quick actions, and session export
Per-user cost tracking and spending limits with configurable rate limiting and timeout controls

Use Cases

  • 01Reviewing and modifying code on mobile devices while away from the development workstation
  • 02Setting up automated code health checks or test runs on a recurring schedule via cron jobs
  • 03Receiving GitHub webhook notifications for pull requests and having Claude automatically summarize changes
  • 04Conducting code reviews and debugging sessions using voice messages during commutes or meetings
  • 05Managing multiple project repositories conversationally using GitHub CLI integration without switching directories manually
  • 06Monitoring CI/CD pipeline results and responding to failures through Telegram notifications

Related Plugins

View more

andrej-karpathy-skills

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

Plugin216.2k

claude-mem

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

Plugin95.1k

Understand-Anything

Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.

Plugin85k

rtk

CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies

Plugin82.2k

claude-code-telegram — FAQ

What is claude-code-telegram?+

It's a Telegram bot plugin that connects Telegram messaging to Claude Code, allowing developers to access their codebase and interact with Claude's AI assistance remotely from any device with Telegram installed.

How do I install claude-code-telegram?+

Install Python 3.11+, Claude Code CLI, and obtain a Telegram bot token from @BotFather. Then install via uv tool install or pip install from the GitHub repository, configure your .env file with the bot token and approved directory, and run with make run.

Do I need an Anthropic API key to use this plugin?+

The API key is optional if you've already authenticated the Claude Code CLI using claude auth login. However, you can provide ANTHROPIC_API_KEY in your .env file for SDK-based authentication instead of relying on CLI credentials.

Which clients does claude-code-telegram work with?+

This plugin works with any Telegram client (mobile, desktop, or web) and requires the Claude Code CLI to be installed on the server where the bot runs.

Is claude-code-telegram free to use?+

The plugin itself is free and open-source under the MIT License. However, you'll incur Claude API usage costs from Anthropic based on your interactions, which you can control with the CLAUDE_MAX_COST_PER_USER spending limit.

What are the differences between agentic mode and classic mode?+

Agentic mode (default) allows natural language conversations with minimal commands and automatic tool selection, while classic mode provides a terminal-like interface with 13 explicit commands for directory navigation, git operations, and structured workflows.

How do I install claude-code-telegram?+

Open the source repository on GitHub and follow its README. claude-code-telegram is a plugin — MCP Agents Market links you directly to the official repo.

Is claude-code-telegram free?+

claude-code-telegram is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.

Related searches

Developer Tools PluginsCommunication PluginsProductivity & Workflow PluginsBest MCP ServersBest SkillsBest AgentsTop rated listingsClaude Code toolsBrowse all categories