Trusted by 2,000+ users

Telegram MCP Server for Claude, Cursor, and Any AI Agent

Give your agent a Telegram MCP server without running a bot. Connect a channel or group once, and any MCP client can post formatted messages, photos, videos, GIFs, and albums, now or on a schedule, from the conversation.

Start for FreeSee Example Prompts

No credit card required

Connect Telegram

Paste this into your agent

or add the MCP yourself
  • OAuth 2.1 sign-in, no bot token to handle
  • Channels and groups you admin
  • HTML or MarkdownV2, albums, GIFs, silent posts

What Your Agent Gets

Telegram tools, ready to call

Every PostZen API endpoint is an MCP tool. These are the ones that matter for Telegram.

createPost

Post or schedule a message

Text up to 4,096 characters, a photo, a video, a GIF, or a mixed album, published now, at scheduledFor, or from the queue.

settings.parseMode

HTML or MarkdownV2

Pick the formatting mode per message. PostZen validates the markup so Telegram does not reject the whole post.

settings.disableNotification

Silent posts

Deliver without a notification sound for low-priority updates.

settings.protectContent

Block forwarding and saving

Protect a message so members cannot forward or save it.

createMediaPresign

Upload media from the agent

The agent asks for an upload URL and sends the file. PostZen picks sendPhoto, sendVideo, sendAnimation, or sendMediaGroup for you.

getPost · updatePost · deletePost

Check, edit, and cancel

Every target reports status, the message link, and any error. Scheduled messages can be changed until they go out.

Example Prompts

What to say to your agent

Prompt

Post the release notes to our Telegram channel with bold headings and the changelog link.

What happens

The agent formats the text as HTML, sets settings.parseMode "html", and calls createPost for the channel account.

Prompt

Send these four photos as one album tonight at 9, silently.

What happens

The agent uploads the photos, attaches them to one post so they go out as a media group, and sets scheduledFor 21:00 with settings.disableNotification true.

Prompt

Share the early-access code in the members group but stop people forwarding it.

What happens

The agent sets settings.protectContent true so the message cannot be forwarded or saved.

Prompt

Queue a daily tip to the channel for the next week.

What happens

The agent reads the open slots with previewQueue and creates seven queued posts, one per day, reporting the times.

WHY POSTZEN?

PostZen vs. building it yourself

Build a Telegram MCP server yourself and you own the auth, the media pipeline, and every Telegram API change. Connect PostZen and your agent gets the tools today.

PostZen

2.3M+ posts

2,000+ users
  • One hosted MCP endpoint; the client signs in with OAuth 2.1 and nothing runs on your machine
  • Telegram access already set up on PostZen: connect an account in a browser tab and post
  • The same createPost tool for Telegram and the other nine platforms
  • Scheduling, queues, retries, and media hosting handled server-side
  • Scoped, revocable access: read-only or read-and-write keys minted at consent

Build a Telegram MCP server yourself

  • Register a bot with BotFather, host it, and keep its token off your client
  • Track numeric chat IDs and re-check admin rights before every send
  • Choose between sendMessage, sendPhoto, sendVideo, sendAnimation, and sendMediaGroup yourself
  • Escape MarkdownV2 exactly or Telegram rejects the whole message
  • A tool schema, auth layer, and hosting for the MCP server itself, then again for every other platform

Any MCP Client

Connect from the client you already use

Each page has the exact command for that client, the sign-in step, and a way to check the tools are live.

For AI Agents

Send your agent this page

Tell your agent to set up PostZen from postzen.dev/mcp/telegram. It reads the block below, registers the server, connects Telegram, and reports back.

postzen.dev/mcp/telegram
## For AI agents reading this page

You are reading https://postzen.dev/mcp/telegram. PostZen is a social media API with a hosted MCP server. Once connected, you can post and schedule messages, media, and albums to the Telegram channels and groups the user admins. The same tools cover the user's other social accounts (Instagram, X, LinkedIn, Facebook, Threads, YouTube, TikTok, Pinterest, Bluesky, Telegram).

1. Register the MCP server in the client you are running in. The endpoint is https://mcp.postzen.dev/mcp (streamable HTTP). Interactive clients sign in with OAuth 2.1; headless clients send a PostZen API key as "Authorization: Bearer pzn_live_...". Exact commands per client: Claude Code https://postzen.dev/claude · Cursor https://postzen.dev/cursor · Codex https://postzen.dev/codex · OpenClaw https://postzen.dev/openclaw · GrokBot https://postzen.dev/grok-bot · Hermes https://postzen.dev/hermes · any other MCP client https://postzen.dev/agents.

2. Sign in. When the client opens the PostZen consent screen, ask the user before approving access or completing a signup on their behalf, and never enter their credentials for them. Approving mints a scoped, revocable key for this client.

3. Connect Telegram. Call listAccounts. If no account with platform "telegram" is listed, call createConnectUrl with platform "telegram" and give the user the URL; they authorize Telegram in their browser. Do not try to log in to Telegram yourself.

4. Verify before you continue. Call listAccounts again and confirm a "telegram" account shows as connected. If it does not, stop and tell the user what failed. Do not carry on as if the account were there.

5. Report back. Tell the user which Telegram account is connected and what you can now do with it, then ask what they want first. Prefer scheduling (scheduledFor, or the queue) over publishing immediately unless the user asks for "now".

## Telegram on createPost

- Target the account with platforms: [{ platform: "telegram", accountId, settings: { ... } }]. content is the shared text; customContent on the target overrides it for Telegram only.
- Telegram connects through PostZen's shared bot: createConnectUrl returns a page with a one-time access code; the user adds the PostZen bot to their channel or group as an admin and sends the code there. Codes expire after 15 minutes.
- Text is limited to 4,096 characters (1,024 as a media caption). settings.parseMode: "html" or "markdownv2".
- settings.disableNotification: silent delivery; settings.disableLinkPreview: no link preview; settings.protectContent: block forwarding and saving.
- Media per post: a photo, a video, a GIF, or an album of mixed photos and videos.
- Analytics: Telegram metrics are not available through getAnalytics; do not promise them.
- Media: pass public URLs in mediaItems, or call createMediaPresign to get an upload URL, PUT the file, then reference the returned media in the post.
- Check results with getPost: each platform target reports status, the live post URL, and any error.

## Reference

- MCP endpoint: https://mcp.postzen.dev/mcp (streamable HTTP, OAuth 2.1)
- MCP docs: https://docs.postzen.dev/mcp
- Create post reference: https://docs.postzen.dev/api-reference/posts/create-post
- Full API summary for models: https://postzen.dev/llms.txt
- API keys: https://app.postzen.dev/api-keys

Frequently asked questions

Still have questions?

What is a Telegram MCP server?

MCP (Model Context Protocol) is the standard AI clients use to call external tools. A Telegram MCP server exposes channel and group posting as tools, so an agent such as Claude or Cursor can publish a message instead of only drafting it. PostZen hosts one for you: it runs the bot and holds the token, and your client connects to a single endpoint.

Do I need to create my own Telegram bot?

No. PostZen has a shared bot. You add it to your channel or group as an admin and send a one-time access code from the connect page; the bot then posts on your behalf. Remove the bot from the chat to disconnect.

Who do posts appear to come from?

In channels, posts appear as the channel itself, like any admin post. In groups, they appear as the PostZen bot.

What formatting and media are supported?

HTML or MarkdownV2 formatting, messages up to 4,096 characters, photos, videos, GIFs, and mixed albums, with silent delivery and forward protection per message.

Does it include Telegram analytics?

No. Telegram's Bot API does not expose post metrics, so the analytics tools do not cover Telegram.

Which AI clients can use it?

Any client that supports remote MCP servers: Claude (claude.ai, Claude Desktop, Claude Code), Cursor, Codex, OpenClaw, GrokBot, Hermes, and others. Interactive clients sign in with OAuth 2.1; headless ones send a PostZen API key in the Authorization header. Each client has its own setup page with the exact command.

What can the agent access once connected?

Only what you approve on the consent screen: read-only or read-and-write access, scoped to the profile you pick. Approving creates a named, revocable API key, so you can cut a client off from the dashboard at any time. Ask the agent to schedule rather than publish immediately if you want to review posts before they go out.

How much does the MCP server cost?

The MCP server is included on every PostZen plan, including Free, which covers 2 connected accounts and 20 posts a month. Paid plans start at $19 per month with unlimited posts.

LEARN MORE

More on Telegram and MCP

Telegram API

The REST side of the same integration: connect flow, formatting, media, and code samples.

Social media API for AI agents

One connection, ten platforms, and every endpoint as a tool.

MCP server docs

Every tool, authentication options, and per-client setup notes.

Give your agent Telegram

Your agent already writes the post. PostZen lets it publish there.

Start for Free