telegram-claude-code

Name: telegram-claude-code
Author: DmacMcgreg

communication MCP Server

Always-on AI agent for Telegram, powered by Claude Agent SDK. Runs 24/7 on your Mac with your Max subscription. $0 API costs. Multimodal: voice, images, YouTube, browser automation, scheduled tasks. Inspired by OpenClaw

byDmacMcgreg

VerifiedInstall Ready

communicationcommunication

8 views1 stars0 forksv0.1.0

View on GitHub

Why This Matters

Discovered via github-topic:mcp and last synced 3mo ago.

VerifiedInstall Ready

Source: github-topic:mcp
Stars: 1
Last synced: 3mo ago
Install: Instructions detected

Install

1. Install the package

npx telegram-claude-code

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "telegram-claude-code": {
      "command": "npx",
      "args": [
        "telegram-claude-code"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

Tools

Resources

Prompts

Standard I/O

Transport

Available Tools (39)

youtube_summarize

Analyze a single video by URL or ID

Runtime

[Bun](https://bun.sh)

TTS

[Edge TTS](https://github.com/rany2/edge-tts) (Sonia British neural voice)

youtube_process_playlist

Batch-process videos from source playlist

Scheduling

[croner](https://github.com/hexagon/croner)

Web

[Hono](https://hono.dev) + HTMX + SSE

YOUTUBE_CLIENT_ID

(optional)

youtube_list

List stored videos with keyword/channel filters

Bot

[grammy](https://grammy.dev)

HEARTBEAT_QUIET_START

`23`

YOUTUBE_SOURCE_PLAYLIST_ID

(optional)

HEARTBEAT_QUIET_END

`8`

youtube_get

Get full analysis for a specific video

Database

SQLite (bun:sqlite, WAL mode, FTS)

Component

Technology

HEARTBEAT_INTERVAL_MINUTES

`30`

YOUTUBE_CLIENT_SECRET

(optional)

GLM_BASE_URL

`https://api.z.ai/api/anthropic`

Tool

Description

youtube_playlist_status

Show processing stats and pending videos

STT

[parakeet](https://docs.nvidia.com/nemo-framework/user-guide/latest/nemotoolkit/asr/models.html#parakeet) (via mlx-audio)

DEFAULT_MAX_BUDGET_USD

`1.00`

Variable

Default

PORT

`3141`

PSIBOT_DIR

`~/.psibot`

GEMINI_API_KEY

(optional)

Command

Description

Validation

[Zod](https://zod.dev)

ALLOWED_TELEGRAM_USER_IDS

(required)

HEARTBEAT_MAX_BUDGET_USD

`0.50`

YOUTUBE_DESTINATION_PLAYLIST_ID

(optional)

DEFAULT_MODEL

`claude-opus-4-6`

GLM_AUTH_TOKEN

(optional)

TELEGRAM_BOT_TOKEN

(required)

HEARTBEAT_ENABLED

`true`

REDDIT_USERNAME

(optional)

youtube_search

Semantic search across all stored video analyses

Agent

[@anthropic-ai/claude-agent-sdk](https://github.com/anthropics/claude-agent-sdk)

Browser

[agent-browser](https://github.com/anthropics/agent-browser)

Works Well With - Skills

c-slack

Send messages and upload files to Slack channels using the `slack` CLI. Supports direct messages, channel posts, file uploads, and thread replies.

4 starsHas guide

c-telegram

Bidirectional Telegram bridge — talk to Claude from your phone. Built into OpenPaw.

4 starsHas guide

mesh-awareness

Discover agents across local node and mesh peers at runtime — their roles, handles, and how to communicate with or delegate to them.

3 starsHas guide

storytelling-with-data

Apply data visualization and storytelling principles from Storytelling with Data by Cole Nussbaumer Knaflic. Covers choosing effective visuals (line, bar, table, scatterplot), eliminating clutter (Gestalt principles, data-ink ratio), focusing attention (preattentive attributes, strategic color), thinking like a designer (affordances, alignment, white space), and narrative structure (three-act story, horizontal/vertical logic, Big Idea). Trigger on "data visualization", "chart design", "dashboard design", "data storytelling", "presentation chart", "declutter chart", "bar chart", "line chart", "data narrative", "slide deck data", "chart review", "viz critique", "storytelling with data".

2 stars

Works Well With - Agents

Awesome Agent Skills For Empirical Research

🔬 A curated collection of 23,000+ agent skills for empirical research across 8 social science disciplines. | 精选 23,000+ AI Agent 技能库，覆盖8大社会科学学科的实证研究。CoPaper.AI 20分钟完成一篇可复现的规范实证论文，并支持用户上传 Skills。-- Maintained by CoPaper.AI from Stanford REAP.

4385 starslangchain

Auto Empirical Research Skills

4108 starslangchain

AgentNetworkProtocol

AgentNetworkProtocol(ANP) is an open source protocol for agent communication. Our vision is to define how agents connect with each other, building an open, secure, and efficient collaboration network for billions of intelligent agents.

1426 stars

telegram-claude-code

Why This Matters

Install

Available Tools (39)

youtube_summarize

Runtime

TTS

youtube_process_playlist

Scheduling

Web

YOUTUBE_CLIENT_ID

youtube_list

Bot

HEARTBEAT_QUIET_START

YOUTUBE_SOURCE_PLAYLIST_ID

HEARTBEAT_QUIET_END

youtube_get

Database

Component

HEARTBEAT_INTERVAL_MINUTES

YOUTUBE_CLIENT_SECRET

GLM_BASE_URL

Tool

youtube_playlist_status

STT

DEFAULT_MAX_BUDGET_USD

Variable

PORT

PSIBOT_DIR

GEMINI_API_KEY

Command

Validation

ALLOWED_TELEGRAM_USER_IDS

HEARTBEAT_MAX_BUDGET_USD

YOUTUBE_DESTINATION_PLAYLIST_ID

DEFAULT_MODEL

GLM_AUTH_TOKEN

TELEGRAM_BOT_TOKEN

HEARTBEAT_ENABLED

REDDIT_USERNAME

youtube_search

Agent

Browser

Works Well With - Skills

c-slack

c-telegram

mesh-awareness

storytelling-with-data

Works Well With - Agents

Awesome Agent Skills For Empirical Research

Auto Empirical Research Skills

AgentNetworkProtocol

Guides & Tutorials

Claude Skill c-slack: A Practical Guide to Sending Slack Messages and Files with Claude

Claude Skill: c-telegram — A Telegram Bridge for Talking to Claude from Your Phone

Letter Writer: A Practical Guide to This Claude Skill for Better Business, Cover, and Personal Letters