newink/telegram-mcp

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

12 stars 7 forks 品質 75 トレンド 12MIT

概要

is an MCP server that exposes your Telegram account as tools for AI agents. It uses (userbot protocol) — not Bot API — which means it can access any chat, channel, or DM your account has access to, without needing to add a bot. Connect it to Claude, Codex, or any MCP-compatible client and let agents read messages, search dialogs, download media, and fetch message links — all from your personal Telegram. Ask your agent to pull the last 50 unread messages from your favorite tech channels, filter for substance, and summarize what's worth reading. Find that message with the link someone sent you three weeks ago in a group of 500 people. Wire your AI agent to periodically check specific channels and pipe interesting content into your workflow — notes, capture files, summaries. Download files, images, or documents from any message your agent finds — useful for automating research pipelines. Full reference with parameters and examples → docs/tools.md Go to my.telegram.

README

以下は原文 README の抜粋です。原文を見る。

What is this?

telegram-mcp is an MCP server that exposes your Telegram account as tools for AI agents. It uses MTProto (userbot protocol) — not Bot API — which means it can access any chat, channel, or DM your account has access to, without needing to add a bot.

Connect it to Claude, Codex, or any MCP-compatible client and let agents read messages, search dialogs, download media, and fetch message links — all from your personal Telegram.

Use Cases

📰 Channel digest Ask your agent to pull the last 50 unread messages from your favorite tech channels, filter for substance, and summarize what’s worth reading.

"Fetch unread messages from @some_channel since yesterday and summarize the key points"

🔍 Search your history Find that message with the link someone sent you three weeks ago in a group of 500 people.

"Search my dialogs for 'MCP server' and find where I discussed it"

🤖 Agent inbox monitoring Wire your AI agent to periodically check specific channels and pipe interesting content into your workflow — notes, capture files, summaries.

📎 Media extraction Download files, images, or documents from any message your agent finds — useful for automating research pipelines.

Tools

Tool	Description
`search_dialogs`	Search chats, groups, and channels by name or username
`get_messages`	Fetch messages with date range, unread filter, and mark-as-read support
`search_messages`	Full-text search across all chats or within a specific chat
`media_download`	Download media (photo, video, document) from a message to a local file
`message_from_link`	Fetch a message by its `t.me/...` link
`delete_messages`	Delete messages from a chat (requires opt-in via `bot-data/config.yml`)
`send_message`	Send a text message to a chat (requires opt-in via `bot-data/config.yml`)
`send_file`	Send a local file to a chat as a document (requires opt-in via `bot-data/config.yml`)

Full reference with parameters and examples → docs/tools.md

Quick Start

1. Get Telegram API credentials

GitHub で README 全文を見る

インストール

docker run -p 3000:3000 \

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "telegram": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}