mcp-telegram

mcp-telegram

1

MCP Telegram is a TypeScript-based server designed to facilitate communication with Telegram using the MTProto protocol. It provides tools and CLI commands to automate Telegram interactions and includes integration with FastMCP for AI model compatibility.

MCP Telegram Overview

This project is a TypeScript implementation of a Model Context Protocol (MCP) server designed to interact with Telegram via the MTProto protocol. It utilizes FastMCP, allowing it to connect with AI models such as Claude. Key features include CLI commands for signing in and out of Telegram, starting the MCP server, and handling transports like stdio and SSE. The server also provides tools for listing dialogs and messages with various filtering options.

Installation

  • Install dependencies and build the project using npm.

Usage

  • Use CLI commands to manage Telegram connections and operate the MCP server.

Server Transports

  • Supports stdio (default, for tools like Cursor AI) and SSE.

Environment Variables

  • Configure API ID, API Hash, transport type, port, and more using environment variables.