claude-code-telegram

A personal AI assistant you can message from anywhere via Telegram.

What is this?

You know how Claude Code runs in your terminal and can read files, run commands, search the web, etc? This lets you talk to it from your phone via Telegram instead of being tied to your computer.

Text your bot → it runs Claude Code → sends back the response.

Some things you can do:

• “What’s on my calendar today?”
• “Search the web for the latest news on X”
• “Read my notes and summarize them”
• “Send me a daily briefing every morning at 7am”

It also works the other way - Claude can message YOU via Telegram (notifications when tasks finish, scheduled briefings, alerts, etc).

The key is skills. Out of the box, Claude Code can read files and search the web. But to make it truly YOUR assistant, create skills that give it access to your stuff:

• Google Calendar (read your schedule)
• Gmail (read-only access to emails)
• Notes app (Obsidian, Apple Notes, etc.)
• Weather for your location
• Whatever else you want

The skills/ folder has examples to get you started.

Quick Start

Open Claude Code and paste:

https://github.com/seedprod/claude-code-telegram - help me set this up

Claude will clone the repo and walk you through the entire setup.

Claude will walk you through:

1. Creating a Telegram bot with @BotFather
2. Getting your user ID from @userinfobot
3. Configuring the .env file
4. Installing the telegram-sender skill globally
5. Setting up launchd to run the bot continuously
6. (Optional) Setting up scheduled skills like daily briefings

---

What’s Included

How It Works

Inbound (you → Claude):

Telegram → telegram-bot.py → claude -p "message" → response → Telegram

Outbound (Claude → you):

Claude skill → telegram-sender/send.sh → Telegram API → you

Manual Setup

If you prefer to set up manually instead of having Claude guide you:

1. Prerequisites

• Claude Code CLI installed and authenticated
• Python 3.10+

2. Create Telegram Bot

1. Message @BotFather on Telegram
2. Send /newbot and follow prompts
3. Copy the bot token

3. Get Your User ID

1. Message @userinfobot on Telegram
2. Copy your user ID

4. Configure

cp .env.example .env
# Edit .env with your token and user ID

5. Install Dependencies

pip install -r requirements.txt

6. Install Skill Globally

cp -r skills/telegram-sender ~/.claude/skills/

7. Run Bot (Manual)

python telegram-bot.py

8. Run Bot (launchd - Recommended)