telegram_mcp

telegram_mcp

6
communication

The Telegram MCP Server is designed to integrate the Telegram API with AI agents and other clients using the Model Context Protocol. Key features include accessing user chats, sending messages, and executing Telegram API methods securely while leveraging Node.js capabilities.

Telegram MCP Server

A server for interacting with the Telegram API using the Model Context Protocol (MCP). It allows AI agents and other MCP clients to access Telegram functionalities.

Requirements

  • Node.js 14+ or higher
  • npm
  • API ID and API Hash from Telegram

Installation

  • Clone the repository and install dependencies.
  • Configure the .env file with your API ID and Hash.

Running

  • The server can be run via npm, direct node execution, as an executable, or after global installation.

Integration with MCP clients

  • Can be configured for use with Cursor and Claude Desktop for command execution.

Available Tools

  • getDialogs: Retrieve user chats.
  • getMessages: Get messages from a specific chat.
  • sendMessage: Send a message to a chat.
  • executeMethod: Use any Telegram API method cautiously.

Security

  • Keep your API credentials and session files secure. Use the executeMethod tool carefully to prevent destructive actions.