Skill

setup

Sets up Telegram CLI by authenticating personal accounts via MTProto sessions using Telethon and configuring 1Password credentials for API keys. For first-time Telegram automation.

Bash

Python

cli-tools

automation

npx claudepluginhub terrylica/cc-skills

Tool Access

This skill is limited to using the following tools:

BashReadWriteAskUserQuestion

Preview

One-time setup to authenticate personal Telegram accounts via MTProto.

SKILL.md

Similar Skills

setup

Sets up Telegram CLI by authenticating personal accounts via MTProto using 1Password credentials. Handles first-time login, re-authentication, and session management for profiles like eon and missterryli.

4 tools

tlg

send-message

Sends messages from personal Telegram accounts via MTProto using Telethon. Supports usernames, chat IDs, or phone numbers with predefined profiles. Use for direct Telegram messaging in workflows.

4 tools

telegram-cli

agent-telegram

Interact with Telegram via TDLib CLI: authenticate accounts, list chats, send messages. Auto-provisions API credentials and supports agent-driven auth flows.

1 tool

agent-messenger

Stats

Parent Repo Stars22

Parent Repo Forks4

Last CommitMar 18, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Telegram CLI Setup

One-time setup to authenticate personal Telegram accounts via MTProto.

Prerequisites

1Password CLI installed: op --version
Telegram API credentials stored in 1Password vault Claude Automation

Available Profiles

Profile	1Password Item	Item UUID	Phone
`eon`	Telegram API - EonLabsOperations	`iqwxow2iidycaethycub7agfmm`	+1 (CA)
`missterryli`	Telegram API - missterryli (CN)	`dk456cs3v2fjilppernryoro5a`	+86 (CN)

Setup Steps

Step 1: Verify 1Password Access

/usr/bin/env bash << 'VERIFY_EOF'
op item get "iqwxow2iidycaethycub7agfmm" --vault "Claude Automation" --fields "App ID" 2>&1
op item get "dk456cs3v2fjilppernryoro5a" --vault "Claude Automation" --fields "App ID" 2>&1
VERIFY_EOF

Step 2: Authenticate (INTERACTIVE - must run in terminal)

Each profile requires a one-time interactive auth. The user must run directly:

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/telegram-cli}"

# Auth eon profile
uv run --python 3.13 "$PLUGIN_DIR/scripts/send.py" -p eon whoami

# Auth missterryli profile
uv run --python 3.13 "$PLUGIN_DIR/scripts/send.py" -p missterryli whoami

Prompts for:

Phone number
Verification code (sent via Telegram)
2FA password (if enabled)

Step 3: Verify

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/telegram-cli}"
uv run --python 3.13 "$PLUGIN_DIR/scripts/send.py" -p eon whoami
uv run --python 3.13 "$PLUGIN_DIR/scripts/send.py" -p missterryli whoami

Session Management

File	Purpose
`~/.local/share/telethon/eon.session`	EonLabsOperations MTProto session
`~/.local/share/telethon/missterryli.session`	missterryli MTProto session

To re-authenticate (e.g., after revoking session in Telegram > Settings > Devices):

rm ~/.local/share/telethon/<profile>.session
# Then re-run whoami for that profile

Adding New Profiles

Edit the PROFILES dict in scripts/send.py:

PROFILES: dict[str, str] = {
    "eon": "iqwxow2iidycaethycub7agfmm",
    "missterryli": "dk456cs3v2fjilppernryoro5a",
    "newprofile": "<1password-item-uuid>",
}

Then store API credentials in 1Password vault Claude Automation with fields App ID and App API Hash.