Telegram MCP Server (chigwell)
Telegram MCPサーバー（chigwell版）でClaude連携・ユーザーアカウントでのTelegram操作を実現
uv /path/to/telegram-mcp run main.py概要
Telegram MCP Server（chigwell版）の設定方法と使い方。
Telegramのユーザーアカウントで各種操作を行えるMCPサーバー。
チャットの操作、メッセージの送受信、連絡先管理、メディアの送受信、プロフィール・プライバシー設定の変更など80以上のツールを備える。
ClaudeとTelegramのMCPサーバー連携により、メッセージの整理・要約や定型メッセージ送信、連絡先管理をClaudeから自動化できる。
ボットではなくユーザーアカウント（MTProtoセッション）ベースで動作し、シングル/マルチアカウントに対応する点が特徴。
設定方法はリポジトリを取得して uv sync 後、APIクレデンシャルとセッション文字列を環境変数に設定するだけで完結する。
料金・APIキー情報
料金
完全無料APIキー
🔑 必要🔑 APIキーの取得方法
- 1
https://my.telegram.org にログインし「API development tools」を開く
- 2
アプリ情報を登録して api_id と api_hash を取得する
- 3
リポジトリ付属の手順でユーザーアカウントのセッション文字列（またはセッションファイル）を生成する
- 4
api_id・api_hash・セッション文字列を環境変数に設定する
こんな使い方ができます
特定チャットのメッセージを取得してClaudeに要約・整理させられる
Claudeの指示で定型メッセージや返信をTelegramに送れる
連絡先の一覧取得・整理をClaudeに任せられる
複数のTelegramアカウントを切り替えながらClaudeに操作させられる
セットアップ手順
- 1
git clone https://github.com/chigwell/telegram-mcp.git でリポジトリを取得し uv sync で依存をインストールする
- 2
https://my.telegram.org でapi_id・api_hashを取得し、付属手順でセッション文字列を生成する
- 3
ターミナルで以下を実行してClaude Codeに追加する：claude mcp add telegram -e TELEGRAM_API_ID=your-api-id -e TELEGRAM_API_HASH=your-api-hash -e TELEGRAM_SESSION_STRING=your-session-string -- uv --directory /path/to/telegram-mcp run main.py
設定ファイル
コピー前に確認
Python環境とuvが必要。リポジトリを取得して uv sync 後、main.py を実行する。https://my.telegram.org で取得した api_id / api_hash と、ユーザーアカウントのセッション文字列（またはセッションファイル）が必要。シングル/マルチアカウント設定に対応。
claude mcp add telegram -e TELEGRAM_API_ID=your-api-id-here -e TELEGRAM_API_HASH=your-api-hash-here -e TELEGRAM_SESSION_STRING=your-session-string-here -- uv --directory /path/to/telegram-mcp run main.py注意事項
既存の「Telegram MCP Server」とは別の実装。chigwell/telegram-mcp は『ボットではなくユーザーアカウント（MTProtoセッション）』で動作するのが特徴で、80以上のツールを公開する。注意：PyPIの telegram-mcp パッケージは無関係の第三者製のため、GitHubリポジトリから直接インストールすること（pip install "git+https://github.com/chigwell/telegram-mcp.git@<tag>" でも可）。ユーザーアカウントを操作するため、利用はTelegramの利用規約の範囲内で行うこと。