Postun — open-source Telegram MCP server: connect your own Telegram to ChatGPT, Claude and Claude Code, in transit, with no message storage

English · Русский · Español · Português · Deutsch

The English README is canonical; translations follow it and may lag behind.

Postun Beta is an open-source MCP (Model Context Protocol) server for Telegram. It links your own Telegram account to ChatGPT, Claude, Claude Code and other MCP clients and works as a transit: when your AI assistant asks, Postun passes it your chats, message search results or public channel posts, and keeps nothing itself. Messages exist only in memory while they are handed over; they are not stored, logged or viewed by Postun, and only read scopes exist, so nothing can be sent, edited or deleted. You decide which accounts and which scopes each AI client gets, and you can revoke access at any time. ChatGPT, Claude, Claude Code and Gemini (web) are verified on production; other MCP clients (Cursor, Gemini CLI, Codex, VS Code, Zed, Qwen Code) support the protocol but are not tested by the project (see Beta status).

• Site: https://postun.org (English, Русский, Español, Português, Deutsch)
• Cabinet: https://app.postun.org
• MCP endpoint: https://mcp.postun.org/mcp
• Repository: https://github.com/AiReformator/postun
• Status: free beta, experimental. No independent security audit has been done.

What it is / Who it's for

Postun is a connector between a Telegram user account (not a bot) and an AI client that speaks MCP. After you link your account, the AI client can call a small set of read-only tools: list your dialogs, read message history, search messages, look at public channels and fetch file metadata or files.

It is for people who want an AI to help with their own Telegram data:

• summarize a group chat or a long conversation you missed;
• find something in your chat history by meaning, not only by keyword;
• review and analyze public channels you follow;
• pull context from Telegram into a ChatGPT, Claude or Claude Code session.

What it is not:

• Not a Telegram bot and not an "AI bot inside Telegram". Nothing is added to your chats and nothing talks in your name.
• Not a way to send messages, delete anything or change anything in Telegram. No write scope exists.
• Not zero-knowledge. See Security and privacy model.

How it works

Telegram login ──> QR link ──> OAuth grant ──> MCP tools
(OIDC, cabinet)   (MTProto,    (you pick the    (read-only calls from
                   optional     accounts and     ChatGPT / Claude /
                   2FA password) read scopes)    Claude Code)

1. Sign in to the cabinet at https://app.postun.org with Telegram.
2. Link your account by scanning a QR code in the Telegram app (MTProto login). If you use a cloud password (2FA), you enter it in the cabinet during linking.
3. Connect an AI client. The client opens an OAuth flow (with PKCE) on Postun's authorization server. On the consent screen you choose which linked accounts and which scopes (accounts, dialogs, history and search, public channels, files) this client may use.
4. The AI client calls MCP tools at https://mcp.postun.org/mcp with its access token. Each call is checked against the grant, then Telegram is read and the result is returned to the client.

You can revoke a client's grant or unlink an account in the cabinet at any time.

Quick start (for users)

1. Open https://postun.org and go to the cabinet https://app.postun.org. Sign in with Telegram.
2. Link your Telegram account with the QR code.
3. Connect your AI client using the MCP URL:

https://mcp.postun.org/mcp

ChatGPT (custom connector, developer mode): in ChatGPT settings enable developer mode, add a custom MCP connector, paste the MCP URL above, and complete the OAuth consent screen. Menu names depend on your plan and ChatGPT version.

Claude Code:

claude mcp add --scope user --transport http postun https://mcp.postun.org/mcp

Then run /mcp inside Claude Code and authenticate postun. Note: the Claude Code flow is verified on production (see the status table).

Gemini (web): in Gemini, open Settings → Connected Apps and add a custom app with the address https://mcp.postun.org/mcp, then approve the sign-in in the browser. Custom apps are not yet available to every account and work only on the web. See the Gemini help.

Other MCP clients that support remote HTTP MCP servers with OAuth can use the same URL. Cursor, Gemini CLI, Codex, VS Code, Zed and Qwen Code support the protocol but are not tested by the project.

Tip for the beta: try it first with a test account or non-sensitive chats.

MCP tools

All tools are read-only. There is no tool that sends, edits or deletes anything, and no write scope. The server enforces the scope of every tool regardless of client hints.

Tool	What it does	Scope
list_accounts	Lists the Telegram accounts this client is allowed to use	accounts:read
list_dialogs	Lists chats, groups and channels (dialogs)	dialogs:read
get_history	Reads message history of a dialog	messages:read
search_messages	Searches messages	messages:read
search_channels	Searches public channels	channels:read
get_channel_posts	Reads posts of a public channel	channels:read
get_media_info	Returns metadata of a file or media item	media:read
get_media	Delivers a file or media item to the AI client	media:read

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗