このサーバーはTelegram APIとAIアシスタントの間の橋渡し役であり、モデルコンテキストプロトコルに基づいています。

[!重要] このサーバーを使用する前に、Telegram API利用規約を読み理解していることを確実にしてください。 Telegram APIの不正使用はアカウントの停止につながる可能性があります。

目次

• MCPって何?
• このサーバーは何をしているの?
• 能力
• プロンプト例
• メッセージ管理
• 組織
• コミュニケーション
• 設置
• ホームブリュー
• NPX
• リリースからの資料
• MacOS
• Linux
• ウィンドウズ
• ソースより
• 構成
• 認可
• クライアント構成
• JSONスキーマバージョン
• スターの歴史

MCPとは何か?

モデルコンテキストプロトコル(MCP)は、Claude DesktopやCursorのようなAIアプリが外部ツールやデータソースに接続できるようにするシステムです。AIアシスタントがローカルサービスやAPIと明確かつ安全に連携しつつ、ユーザー自身がコントロールできるようにします。

このサーバーは何をしているの?

能力

• [x] 当座預金情報の取得 (tool: tg_me)
• [x] 未読フィルター([tool: tg_dialogs)を含むリストダイアログ
• [x] ダイアログを既読とマークする (tool: tg_read)

Telegram MCP server

The server is a bridge between the Telegram API and the AI assistants and is based on the Model Context Protocol.

[!IMPORTANT] Ensure that you have read and understood the Telegram API Terms of Service before using this server. Any misuse of the Telegram API may result in the suspension of your account.

Table of Contents

• What is MCP?
• What does this server do?
  • Capabilities
  • Prompt examples
    • Message Management
    • Organization
    • Communication
• Installation
  • Homebrew
  • NPX
  • From Releases
    • MacOS
    • Linux
    • Windows
  • From Source
• Configuration
  • Authorization
  • Client Configuration
  • JSON Schema Version
• Star History

What is MCP?

The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop or Cursor, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.

What does this server do?

Capabilities

• [x] Get current account information (tool: tg_me)
• [x] List dialogs with optional unread filter (tool: tg_dialogs)
• [x] Mark dialog as read (tool: tg_read)
• [x] Retrieve messages from specific dialog (tool: tg_dialog)
• [x] Send draft messages to any dialog (tool: tg_send)

Prompt examples

Here are some example prompts you can use with AI assistants:

Message Management

• “Check for any unread important messages in my Telegram”
• “Summarize all my unread Telegram messages”
• “Read and analyze my unread messages, prepare draft responses where needed”
• “Check non-critical unread messages and give me a brief overview”

Organization

• “Analyze my Telegram dialogs and suggest a folder structure”
• “Help me categorize my Telegram chats by importance”
• “Find all work-related conversations and suggest how to organize them”