FlowTruxFlowTrux/Docs
Docsmcp

Telegram MCP Server

Send messages and documents via Telegram Bot API from workflows

The Telegram MCP server lets your workflows send text messages, documents, and formatted reports through a Telegram bot.

Setup

1. Create a Bot

  1. Open Telegram and search for @BotFather.
  2. Send /newbot and follow the prompts to name your bot.
  3. BotFather will reply with a bot token (looks like 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11).
  4. Copy this token.

2. Get Your Chat ID

To find the chat ID where the bot should send messages:

  1. Send any message to your new bot in Telegram.
  2. Open this URL in a browser (replace YOUR_BOT_TOKEN with the actual token): 
    https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates
  3. Look for "chat":{"id": in the JSON response. That number is your chat ID.

For group chats, add the bot to the group first, then send a message in the group and check /getUpdates again. Group chat IDs are negative numbers.

3. Add to FlowTrux

  1. Go to Settings > MCP Servers > Add Server.
  2. Select Telegram.
  3. Paste the Bot Token.
  4. Enter the Chat ID (this becomes the default recipient).
  5. Click Save.

Tools

send_message

Send a text message to a Telegram chat.

ParameterTypeRequiredDescription
textstringYesMessage text (supports Markdown and HTML)
chat_idstringNoRecipient chat ID (defaults to configured Chat ID)
parse_modestringNoMarkdown, MarkdownV2, or HTML (default: HTML)
disable_notificationbooleanNoSend silently without notification sound

send_document

Send a document or file via URL.

ParameterTypeRequiredDescription
document_urlstringYesURL of the document to send
chat_idstringNoRecipient chat ID
captionstringNoCaption for the document
filenamestringNoCustom filename

send_formatted_report

Send a styled report with key-value metrics.

ParameterTypeRequiredDescription
titlestringYesReport title
metricsobjectYesKey-value pairs of metrics to display
chat_idstringNoRecipient chat ID
summarystringNoAdditional summary text (sent as a separate message if provided)

Long summaries are automatically split into multiple messages to respect Telegram's 4096-character limit.

get_updates

Get recent messages and updates from the bot. Useful for testing the connection.

ParameterTypeRequiredDescription
limitnumberNoMaximum updates to retrieve (default: 10)

Example Workflow

A monitoring and notification pattern:

  1. Trigger -- Cron schedule (every 30 minutes)
  2. Action -- HTTP request to check a service health endpoint
  3. Logic -- If-else: check if status is not healthy
  4. Agent -- Compose an alert message, tools: telegram:send_message
  5. The agent sends an alert to the configured Telegram chat when the service is down.
← SlackGoogle Workspace→