MCP.so
Sign In

Telegram MCP Server

@NexusX-MCP

Repository

About Telegram MCP Server

An MCP server implementation that provides tools for interacting with the [Telegram Bot API](

#telegram#bot-api#mcp-server

Basic information

Category

Communication

License

MIT license

Runtime

node

Transports

stdio

Publisher

NexusX-MCP

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "telegram-mcp-server-nexusx-mcp": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "node",
        "dist/index.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Telegram MCP Server?

An MCP server that provides tools for interacting with the Telegram Bot API. It allows AI assistants to send messages, retrieve bot information, receive updates, and forward messages programmatically.

How to use Telegram MCP Server?

Set the TELEGRAM_BOT_TOKEN environment variable with your bot token from @BotFather. Install dependencies with npm install, build with npm run build, and run the server with npx @modelcontextprotocol/inspector node dist/index.js. Open http://127.0.0.1:6274 to configure and test the tools.

Key features of Telegram MCP Server

  • get_bot_info: Retrieves basic bot information (no parameters required)
  • send_message: Sends a message to a specified chat (requires chatId and text)
  • get_updates: Receives incoming updates using long polling (optional offset, limit, timeout, allowed_updates)
  • forward_message: Forwards messages between chats (requires chatId, fromChatId, messageId)
  • All tools accept optional parameters for additional Telegram API features

Use cases of Telegram MCP Server

  • AI assistant sending notifications or replies to a Telegram chat
  • Retrieving bot details (name, username, etc.) for verification or display
  • Polling for new messages, channel posts, callback queries, or other updates
  • Forwarding messages from one chat or channel to another
  • Integrating Telegram messaging into automated workflows without a full bot client

FAQ from Telegram MCP Server

How do I get a Telegram bot token?

Talk to @BotFather on Telegram, create a new bot with the /newbot command, and copy the generated token. Keep it secure.

What environment variable is required?

You must set TELEGRAM_BOT_TOKEN to your bot token. The token is a string like 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw.

What runtime or dependencies are needed?

The server requires Node.js and npm. Run npm install to install dependencies, then build with npm run build.

Can I customize message formatting (parse_mode, reply_markup)?

Yes, the send_message tool accepts an optional params object that includes parameters like parse_mode, reply_markup, etc.

Is the server licensed for commercial use?

Yes, the server is licensed under the MIT License, which permits free use, modification, and distribution.

Comments

More Communication MCP servers

Slack MCP Server

korotovsky

The most powerful MCP Slack Server with no permission requirements, Apps support, GovSlack, DMs, Group DMs and smart history fetch logic.

1.7K

PhonePi MCP: Turn your phone into a toolbox for AI assistants using Model Context Protocol

priyankark

PhonePi MCP enables seamless integration between desktop AI tools and your smartphone, providing 23+ direct actions including SMS messaging, phone calls, contact management, snippet creation and search, clipboard sharing, notifications, battery status checks, and remote device co

35

Email sending MCP 💌

ykhli

The official MCP server to send emails and interact with Resend

549

Discord Mcp

SaseQ

A MCP server for the Discord integration. Enable your AI assistants to seamlessly interact with Discord. Enhance your Discord experience with powerful automation capabilities.

387

WhatsApp MCP Server (TypeScript/Baileys)

jlucaso1

WhatsApp MCP Server (TypeScript/Baileys)

67