How to post to Telegram from Claude Code

Set it up and post, step by step

Prompt to copy once Telegram is connected: Summarize what we merged this week from git log, write it as a Telegram post with the three changes and a link to the changelog, show it to me, and schedule it for Friday at 9am.

1. Add PostWire to Claude Code

   In your terminal run claude mcp add --transport http postwire https://postwire.io/api/mcp (add --scope user to have it in every project), then type /mcp in Claude Code and pick postwire to sign in. The sign-in asks for your email and a 6-digit code, which also creates a free PostWire account if you have none: no password and no card.

2. Or install the skill instead

   npx skills add https://postwire.io --skill schedule-posts adds PostWire's scheduling skill to Claude Code (and to the other agents on the machine). It uses your key from the environment: copy it in the dashboard under API & MCP and set POSTWIRE_API_KEY. The skill is a plain file you can read first: schedule-posts/SKILL.md.

3. Create a bot and make it an admin

   In Telegram, message @BotFather, send /newbot, pick a name and copy the token it gives you. Then open your channel or group and add that bot as an admin, so it is allowed to post there.

4. Connect Telegram

   Ask "connect my Telegram channel". Claude Code calls create_connect_link and prints a one-hour link; open it, choose Telegram and paste the Bot token and Your channel as @yourchannel (a private channel or group goes by its numeric id, which starts with -100). There is no sign-in screen. Before saving, PostWire asks Telegram whether that bot can reach that chat, so a mistyped channel or a bot that is not an admin yet is caught on that page, with the fix.

5. Ask for the message

   "Write this week's Telegram update." generate_posts returns a draft and publishes nothing: clear and direct, light formatting, links welcome and no hashtags. Ask for the Discord or Bluesky version in the same sentence and each comes back written for its own network.

6. Post now, or schedule it

   Say "post it" and Claude Code calls post_to_social. Say "schedule it for Friday at 9am" and it calls schedule_post, up to 365 days ahead, or with run_at: "next_slot" for your next free posting hour. Add photo_url or video_url (a public https link) and the text becomes the caption of that photo or video. A file on your computer goes through an upload page: ask for one (create_upload_link), pick the file there, and Claude Code gets its link. One file can be up to 100 MB on the free plan and 1 GB on paid plans. This is the call:

   {
     "name": "schedule_post",
     "arguments": {
       "platforms": ["telegram"],
       "per_platform": { "telegram": {
         "text": "This week in v2.4 ✨\n\n• Dark mode\n• Sync is 2x faster\n• 14 fixes\n\nChangelog: https://example.com/changelog"
       } },
       "run_at": "2026-10-23T09:00:00-05:00"
     }
   }

7. Open the message

   The result lists Telegram with ok, the message id and its link: https://t.me/yourchannel/123 for a public channel, https://t.me/c/…/123 for a private one (it opens for members). get_post_status returns the same link later.

"What's scheduled on Telegram?" calls list_scheduled_posts and "cancel Friday's update" calls cancel_scheduled_post; the same queue is on the dashboard's Queue page. Prefer to set it up by hand first? Open the dashboard, connect the account under Accounts and copy your key under API & MCP.