Windsurf + Telegram
Post to Telegram from Windsurf
Ask Windsurf to write and schedule your Telegram messages. BrokenPost connects the two, follows Telegram's rules and posts at the time you pick.
How to connect Windsurf to Telegram
- 1
Connect Telegram in BrokenPost. Add the BrokenPost bot to your channel or group as an admin, then connect it.
- 2
In BrokenPost, open Plugins and copy your MCP URL.
- 3
Add the config below to ~/.codeium/windsurf/mcp_config.json.
- 4
Sign in to BrokenPost when asked and allow access.
- 5
Ask the agent to schedule a post.
{
"mcpServers": {
"brokenpost": { "serverUrl": "<MCP_URL>" }
}
}What to ask Windsurf
Type these in Windsurf. Change the details to fit your messages.
- “Post this announcement in my Telegram channel tomorrow at 8am with the link in bold.”
- “Every Monday at 9am, post this reminder in our Telegram group.”
- “Send this video to my Telegram channel on Friday evening.”
- “Read the commits since the last tag and turn them into a short Telegram message. Schedule it for 10am tomorrow.”
- “What Telegram messages do I have scheduled for next week?”
What happens next
- 1
You ask in Windsurf, in plain words.
- 2
Windsurf lists the channels you connected in BrokenPost and picks your Telegram account.
- 3
It reads Telegram's rules and settings from BrokenPost, so the message fits Telegram's limits before it is written.
- 4
If you shared a picture, a video or a link to one, it uploads it to your media library.
- 5
It creates the message as scheduled, as a draft, or to go out now, and gives you a preview link.
- 6
At the set time BrokenPost publishes it to Telegram and it shows on your calendar.
Telegram limits Windsurf follows
Windsurf reads these rules from BrokenPost before it writes, so the message fits the first time.
| Characters | 4,096 characters |
|---|---|
| Media | Photos, videos and files |
| Formatting | Bold, italic, links and more |
| Files | Media Telegram can not show inline is sent as a file |
| Replies | Yes |
If Telegram rejects a message
Windsurf sees the same message and can fix the message for you.
| What you see | How to fix it |
|---|---|
| Posts never show up in the channel | Make the BrokenPost bot an admin with the right to post messages, then retry. |
Good to know
- The bot must be an admin in the channel or group.
- Each message can have up to 4,096 characters.
- Windsurf only posts when you ask. Ask for a draft to check the message in BrokenPost first.
Questions people ask
Can Windsurf post to Telegram directly?
Yes, through BrokenPost. Connect Telegram in BrokenPost, connect BrokenPost to Windsurf, and Windsurf can schedule, draft or publish Telegram messages.
Does Windsurf know the Telegram limits?
Yes. Windsurf reads Telegram's rules from BrokenPost before it writes: 4,096 characters and photos, videos and files. BrokenPost checks again before it posts.
Can Windsurf schedule Telegram messages for later?
Yes. Give a day and time, like "Friday at 6pm", and the message goes out then. Ask for a draft if you want to check it first.
Is it free?
Windsurf with BrokenPost works on every plan. The Free plan includes 1 account on every app and 20 posts a month. Paid plans start at $19 a month with unlimited posts.
Can Windsurf post a Telegram thread or comments?
Yes. Ask for a thread or a first comment and BrokenPost posts each part as a reply, right after the first one.
Why does the bot need to be an admin?
Telegram only lets admins post in channels. Make the bot an admin with the right to post messages.
More apps with Windsurf
Post to Telegram with other AI
Write once. Post everywhere.
Start free with BrokenPost. Connect your apps and your AI in a few minutes.