tgfmcp

Overview

tgfmcp is a specialized MCP server that bridges the Telegram Bot API with MCP-compatible clients. It uses Telegraf directly for polling and API operations, providing comprehensive tools for message manipulation (send, reply, edit, delete, etc.) and chat information retrieval. The server can optionally emit incoming message events through an MCP notification channel, allowing real-time interaction with Telegram conversations. It includes security features through user and chat allowlists and handles media attachments by storing them locally.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• telegram_get_me

  Get information about the Telegram bot

  Try:Get my bot informationTry:Show me the bot details
• telegram_get_status

  Get the status of the Telegram bot

  Try:Check bot statusTry:Is the bot working?
• telegram_get_chat

  Get information about a specific chat

  Try:Get details for chat 123Try:Tell me about this chat
• telegram_get_chat_administrators

  Get the administrators of a specific chat

  Try:List admins in this chatTry:Who are the administrators?
• telegram_lookup_chat

  Look up chat information

  Try:Find this chatTry:Look up the chat details
• telegram_send_message

  Send a message to a chat

  Try:Send 'Hello' to chat 123Try:Tell them the meeting is at 3pm
• telegram_send_media_from_base64

  Send media from base64 encoding

  Try:Send this image to the groupTry:Share the document with them
• telegram_send_media_from_path

  Send media from a file path

  Try:Send the photo from my computerTry:Share the attachment file
• telegram_reply_to_message

  Reply to a specific message

  Try:Reply to message 456 with 'Thanks'Try:Agree with that message
• telegram_react_to_message

  React to a message with an emoji

  Try:React with 👍 to that messageTry:Show thumbs up
• telegram_edit_message

  Edit an existing message

  Try:Update that messageTry:Fix the typo in my message
• telegram_delete_message

  Delete a message

  Try:Remove that messageTry:Delete the previous message

Comparable tools

Installation

npm install -g tgfmcp

tgfmcp configure

tgfmcp mcp

{
  "mcpServers": {
    "telegram": {
      "command": "tgfmcp",
      "args": ["mcp"]
    }
  }
}

FAQ

Can this MCP server receive Telegram messages in real-time?

Yes, when started with --channels flag, it can emit incoming message events through MCP notification channel.

How do I secure access to my Telegram bot through MCP?

Use the interactive configuration to set up allowlists for specific users and chats that can interact with your bot.

Compare tgfmcp with