{"_id":"@chaindead/telegram-mcp_windows_amd64","_rev":"5-804961ac8da0f0b7b993c2f087b39641","name":"@chaindead/telegram-mcp_windows_amd64","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.14-SNAPSHOT-59a2970":{"name":"@chaindead/telegram-mcp_windows_amd64","version":"0.1.14-SNAPSHOT-59a2970","keywords":[],"_id":"@chaindead/telegram-mcp_windows_amd64@0.1.14-SNAPSHOT-59a2970","maintainers":[{"name":"chaindead","email":"miromaxxs@gmail.com"}],"os":["win32"],"bin":{"telegram-mcp_windows_amd64":"telegram-mcp.exe"},"cpu":["x64"],"dist":{"shasum":"813e8d386ecf25692761a01dc09ab74a4b3ba28f","tarball":"https://registry.npmjs.org/@chaindead/telegram-mcp_windows_amd64/-/telegram-mcp_windows_amd64-0.1.14-SNAPSHOT-59a2970.tgz","fileCount":4,"integrity":"sha512-Q/Bpgg/9NUjzU58zqZWzI596yPtsofwvaPUd8T5kb9bVOL8d40PLefJQiVkNSJTOQ/euF900qQUJeXj+quetSw==","signatures":[{"sig":"MEQCIBq2Ue+fAZBLRde1l8GC3MAfpZtbZZn6P2k6Kj7b1fRcAiBY9DOE63OP11KLNtQo8U3Tt1XI6Y0AR8j0871Xr4yDxg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35516811},"gitHead":"ddfa17718a21fcc37830dd357f4c90c501b9e8f0","_npmUser":{"name":"chaindead","email":"miromaxxs@gmail.com"},"_npmVersion":"10.9.2","description":"[![](https://badge.mcpx.dev?type=server 'MCP Server')](https://github.com/punkpeye/awesome-mcp-servers?tab=readme-ov-file#communication) [![](https://img.shields.io/badge/OS_Agnostic-Works_Everywhere-purple)](https://github.com/chaindead/telegram-mcp?tab=","directories":{},"_nodeVersion":"23.9.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/telegram-mcp_windows_amd64_0.1.14-SNAPSHOT-59a2970_1744139155410_0.09570055257991505","host":"s3://npm-registry-packages-npm-production"}},"0.1.21":{"name":"@chaindead/telegram-mcp_windows_amd64","version":"0.1.21","keywords":[],"_id":"@chaindead/telegram-mcp_windows_amd64@0.1.21","maintainers":[{"name":"chaindead","email":"miromaxxs@gmail.com"}],"os":["win32"],"bin":{"telegram-mcp_windows_amd64":"telegram-mcp.exe"},"cpu":["x64"],"dist":{"shasum":"e7a69d908a37070a071fa94e8b6d32a62dd3689b","tarball":"https://registry.npmjs.org/@chaindead/telegram-mcp_windows_amd64/-/telegram-mcp_windows_amd64-0.1.21.tgz","fileCount":4,"integrity":"sha512-SQH0zpnyUQnCy2pjTaGJDsNHf1tGCxrb2nODQOI1TRuix82LAIbp3fwFT0TlzjxUAri5M/uyiYAQTXnmfZzcuQ==","signatures":[{"sig":"MEQCIEJFMiKbjCYvFOi3LHPGK0KFUpfszc1Sm/f4YbBYG/x0AiBcgk2GkcBvqCFIUYwUGRzpnZuGGrcP4HI6CtkZg9DQUg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35502123},"gitHead":"178969b8d8be6a698323b6dd433beec7d6ac4e3f","_npmUser":{"name":"chaindead","email":"miromaxxs@gmail.com"},"_npmVersion":"10.8.2","description":"Telegram MCP server with API integration for accessing user data, managing dialogs (chats, channels, groups), retrieving messages, and handling read status.","directories":{},"_nodeVersion":"20.19.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/telegram-mcp_windows_amd64_0.1.21_1744139985598_0.8089297136482498","host":"s3://npm-registry-packages-npm-production"}},"0.1.22":{"name":"@chaindead/telegram-mcp_windows_amd64","version":"0.1.22","keywords":[],"_id":"@chaindead/telegram-mcp_windows_amd64@0.1.22","maintainers":[{"name":"chaindead","email":"miromaxxs@gmail.com"}],"os":["win32"],"bin":{"telegram-mcp_windows_amd64":"telegram-mcp.exe"},"cpu":["x64"],"dist":{"shasum":"d00cc4465bca6ef888927ea10e77c4be5e673875","tarball":"https://registry.npmjs.org/@chaindead/telegram-mcp_windows_amd64/-/telegram-mcp_windows_amd64-0.1.22.tgz","fileCount":4,"integrity":"sha512-2U2Tl1r5kfeM8ZCOSz4v9Xvm72dAqu7XWaNxE+NzGWcD7doD2uIOkId+TkPI/YPQ3SoZW3mOeCkDZMvC89Xm0A==","signatures":[{"sig":"MEYCIQCcPuzwuXslLb6LdGXPKiF0mHL0jICiRxM+uZOrI1faGwIhANS5dGjHoAqk0SayiXLpu24pcrFvf8rYJ9XHWSaQkGeM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35512129},"gitHead":"911e761430a0758ed04f0c1f2611cf301956a49c","_npmUser":{"name":"chaindead","email":"miromaxxs@gmail.com"},"_npmVersion":"10.8.2","description":"Telegram MCP server with API integration for accessing user data, managing dialogs (chats, channels, groups), retrieving messages, and handling read status.","directories":{},"_nodeVersion":"20.19.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/telegram-mcp_windows_amd64_0.1.22_1744926638436_0.4428435901852783","host":"s3://npm-registry-packages-npm-production"}},"0.1.23":{"name":"@chaindead/telegram-mcp_windows_amd64","version":"0.1.23","keywords":[],"_id":"@chaindead/telegram-mcp_windows_amd64@0.1.23","maintainers":[{"name":"chaindead","email":"miromaxxs@gmail.com"}],"os":["win32"],"bin":{"telegram-mcp_windows_amd64":"telegram-mcp.exe"},"cpu":["x64"],"dist":{"shasum":"92c629b159850d94c07c88c2af6b887e3a475ef5","tarball":"https://registry.npmjs.org/@chaindead/telegram-mcp_windows_amd64/-/telegram-mcp_windows_amd64-0.1.23.tgz","fileCount":4,"integrity":"sha512-CURo02bVcgwonEGOSBIO8a7GnrPZS+iiMV/e87ibHNEWr8FbtJuPYP5VwgXLAowogOgK4sy/G8+kgPhDEcc/cg==","signatures":[{"sig":"MEYCIQDhNb3xmb5oaYBEAtAy8lShAo6tM/bwEprgD8mlXgiHTgIhAOSwOcI78WrlSryeC4dQfhVV2f0KnksY+3sea83t62GZ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35664705},"gitHead":"ba919808e085bc1e0299c21bac5c4103cefd6446","_npmUser":{"name":"chaindead","email":"miromaxxs@gmail.com"},"_npmVersion":"10.8.2","description":"Telegram MCP server with API integration for accessing user data, managing dialogs (chats, channels, groups), retrieving messages, and handling read status.","directories":{},"_nodeVersion":"20.19.4","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/telegram-mcp_windows_amd64_0.1.23_1755773410682_0.19468573837710168","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@chaindead/telegram-mcp_windows_amd64","version":"0.2.0","bin":{"telegram-mcp_windows_amd64":"telegram-mcp.exe"},"os":["win32"],"cpu":["x64"],"keywords":[],"description":"Telegram MCP server with API integration for accessing user data, managing dialogs (chats, channels, groups), retrieving messages, and handling read status.","_id":"@chaindead/telegram-mcp_windows_amd64@0.2.0","gitHead":"1c2c03a79204f388ede69835a0c181bbf58b510e","_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-pcQC26i1o3E7T177XB7eK5kdM4caLPn46zjVlQeLRBrj7wJDVeJV98wqNhGgu7b1DtLQh0i1hqHewK7PCIdjAw==","shasum":"74e03d5e8ec6a9d5117fdd568eab84f5dd8861d3","tarball":"https://registry.npmjs.org/@chaindead/telegram-mcp_windows_amd64/-/telegram-mcp_windows_amd64-0.2.0.tgz","fileCount":4,"unpackedSize":38167372,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCrpxr4ZsspYgYzxnvExQSk5o9/yq2DA2uVSh/RUXpGUwIhAPpxe+a8VZP6+1/axoT79QZ6pQCQ9dTj0n3zL5zDB2UY"}]},"_npmUser":{"name":"chaindead","email":"miromaxxs@gmail.com"},"directories":{},"maintainers":[{"name":"chaindead","email":"miromaxxs@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/telegram-mcp_windows_amd64_0.2.0_1772228237464_0.7685822764579713"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-08T19:05:55.341Z","modified":"2026-02-27T21:37:18.025Z","0.1.14-SNAPSHOT-59a2970":"2025-04-08T19:05:55.840Z","0.1.21":"2025-04-08T19:19:45.968Z","0.1.22":"2025-04-17T21:50:38.913Z","0.1.23":"2025-08-21T10:50:11.028Z","0.2.0":"2026-02-27T21:37:17.903Z"},"keywords":[],"description":"Telegram MCP server with API integration for accessing user data, managing dialogs (chats, channels, groups), retrieving messages, and handling read status.","maintainers":[{"name":"chaindead","email":"miromaxxs@gmail.com"}],"readme":"[![](https://badge.mcpx.dev?type=server 'MCP Server')](https://github.com/punkpeye/awesome-mcp-servers?tab=readme-ov-file#communication)\n[![](https://img.shields.io/badge/OS_Agnostic-Works_Everywhere-purple)](https://github.com/chaindead/telegram-mcp?tab=readme-ov-file#installation)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Visitors](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2Fchaindead%2Ftelegram-mcp&label=Visitors&labelColor=%23d9e3f0&countColor=%23697689&style=flat&labelStyle=none)](https://visitorbadge.io/status?path=https%3A%2F%2Fgithub.com%2Fchaindead%2Ftelegram-mcp)\n\n# Telegram MCP server\n\nThe server is a bridge between the Telegram API and the AI assistants and is based on the [Model Context Protocol](https://modelcontextprotocol.io).\n\n> [!IMPORTANT]\n> Ensure that you have read and understood the [Telegram API Terms of Service](https://core.telegram.org/api/terms) before using this server.\n> Any misuse of the Telegram API may result in the suspension of your account.\n\n## Table of Contents\n- [What is MCP?](#what-is-mcp)\n- [What does this server do?](#what-does-this-server-do)\n - [Capabilities](#capabilities)\n - [Prompt examples](#prompt-examples)\n - [Message Management](#message-management)\n - [Organization](#organization)\n - [Communication](#communication)\n- [Installation](#installation)\n - [Homebrew](#homebrew)\n - [NPX](#npx)\n - [From Releases](#from-releases)\n - [MacOS](#macos)\n - [Linux](#linux)\n - [Windows](#windows)\n - [From Source](#from-source)\n- [Configuration](#configuration)\n - [Authorization](#authorization)\n - [Client Configuration](#client-configuration)\n - [JSON Schema Version](#json-schema-version)\n- [Star History](#star-history)\n\n## What is MCP?\n\nThe Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop or Cursor, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.\n\n## What does this server do?\n\n### Capabilities\n\n- [x] Get current account information (`tool: tg_me`)\n- [x] List dialogs with optional unread filter (`tool: tg_dialogs`)\n- [x] Mark dialog as read (`tool: tg_read`)\n- [x] Retrieve messages from specific dialog (`tool: tg_dialog`)\n- [x] Send draft messages to any dialog (`tool: tg_send`)\n\n### Prompt examples\n\nHere are some example prompts you can use with AI assistants:\n\n#### Message Management\n- \"Check for any unread important messages in my Telegram\"\n- \"Summarize all my unread Telegram messages\"\n- \"Read and analyze my unread messages, prepare draft responses where needed\"\n- \"Check non-critical unread messages and give me a brief overview\"\n\n#### Organization\n- \"Analyze my Telegram dialogs and suggest a folder structure\"\n- \"Help me categorize my Telegram chats by importance\"\n- \"Find all work-related conversations and suggest how to organize them\"\n\n#### Communication\n- \"Monitor specific chat for updates about [topic]\"\n- \"Draft a polite response to the last message in [chat]\"\n- \"Check if there are any unanswered questions in my chats\"\n\n## Installation\n\n### Homebrew\n\nYou can install a binary release on macOS/Linux using brew:\n\n```bash\n# Install\nbrew install chaindead/tap/telegram-mcp\n\n# Update\nbrew upgrade chaindead/tap/telegram-mcp\n```\n\n### NPX\n\nYou can run the latest version directly using npx (supports macOS, Linux, and Windows):\n\n```bash\nnpx -y @chaindead/telegram-mcp\n```\n\nWhen using NPX, modify the standard commands and configuration as follows:\n\n- [Authentication command](#authorization) becomes:\n```bash\nnpx -y @chaindead/telegram-mcp auth ...\n```\n\n- [Claude MCP server configuration](#client-configuration) becomes:\n```json\n{\n \"mcpServers\": {\n \"telegram\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@chaindead/telegram-mcp\"],\n \"env\": {\n \"TG_APP_ID\": \"\",\n \"TG_API_HASH\": \"\"\n }\n }\n }\n}\n```\n\nFor complete setup instructions, see [Authorization](#authorization) and [Client Configuration](#client-configuration).\n\n### From Releases\n\n#### MacOS\n\n
\n\n> **Note:** The commands below install to `/usr/local/bin`. To install elsewhere, replace `/usr/local/bin` with your preferred directory in your PATH.\n\nFirst, download the archive for your architecture:\n\n```bash\n# For Intel Mac (x86_64)\ncurl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_x86_64.tar.gz\n\n# For Apple Silicon (M1/M2)\ncurl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_arm64.tar.gz\n```\n\nThen install the binary:\n\n```bash\n# Extract the binary\nsudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin\n\n# Make it executable\nsudo chmod +x /usr/local/bin/telegram-mcp\n\n# Clean up\nrm telegram-mcp.tar.gz\n```\n
\n\n#### Linux\n
\n\n> **Note:** The commands below install to `/usr/local/bin`. To install elsewhere, replace `/usr/local/bin` with your preferred directory in your PATH.\n\nFirst, download the archive for your architecture:\n\n```bash\n# For x86_64 (64-bit)\ncurl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_x86_64.tar.gz\n\n# For ARM64\ncurl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_arm64.tar.gz\n```\n\nThen install the binary:\n\n```bash\n# Extract the binary\nsudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin\n\n# Make it executable\nsudo chmod +x /usr/local/bin/telegram-mcp\n\n# Clean up\nrm telegram-mcp.tar.gz\n```\n
\n\n#### Windows\n\n
\n\n#### Windows\n1. Download the latest release for your architecture:\n - [Windows x64](https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Windows_x86_64.zip)\n - [Windows ARM64](https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Windows_arm64.zip)\n2. Extract the `.zip` file\n3. Add the extracted directory to your PATH or move `telegram-mcp.exe` to a directory in your PATH\n
\n\n### From Source\n\nRequirements:\n- Go 1.24 or later\n- GOBIN in PATH\n\n```bash\ngo install github.com/chaindead/telegram-mcp@latest\n```\n\n## Configuration\n\n### Authorization\n\nBefore you can use the server, you need to connect to the Telegram API.\n\n1. Get the API ID and hash from [Telegram API](https://my.telegram.org/auth)\n2. Run the following command:\n > __Note:__\n > If you have 2FA enabled: add --password <2fa_password>\n\n > __Note:__\n > If you want to override existing session: add --new\n\n ```bash\n telegram-mcp auth --app-id --api-hash --phone \n ```\n\n 📩 Enter the code you received from Telegram to connect to the API.\n\n3. Done! Please give this project a ⭐️ to support its development.\n\n### Client Configuration\n\nExample of Configuring Claude Desktop to recognize the Telegram MCP server.\n\n1. Open the Claude Desktop configuration file:\n - in MacOS, the configuration file is located at `~/Library/Application Support/Claude/claude_desktop_config.json`\n - in Windows, the configuration file is located at `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n > __Note:__\n > You can also find claude_desktop_config.json inside the settings of Claude Desktop app\n\n2. Add the server configuration\n \n for Claude desktop:\n ```json\n {\n \"mcpServers\": {\n \"telegram\": {\n \"command\": \"telegram-mcp\",\n \"env\": {\n \"TG_APP_ID\": \"\",\n \"TG_API_HASH\": \"\",\n \"PATH\": \"\",\n \"HOME\": \"\",\n \"TG_API_HASH\": \"\"\n }\n }\n }\n }\n ```\n\n### JSON Schema Version\n\nSome MCP clients (e.g. VS Code) do not support JSON Schema Draft 2020-12 and will reject tools that use it. You can override the JSON Schema version by setting the `--schema-version` flag or the `TG_SCHEMA_VERSION` environment variable.\n\nCommon values:\n| Version | URL |\n|---------|-----|\n| Draft-07 (recommended for VS Code) | `https://json-schema.org/draft-07/schema#` |\n| Draft 2020-12 (default) | `https://json-schema.org/draft/2020-12/schema` |\n\n## Star History\n\n\n \n \n \n \"Star\n \n","readmeFilename":"README.md"}