{"_id":"@chaindead/telegram-mcp_windows_arm64","_rev":"5-8948640d24b2862d95a107ccfb0477a1","name":"@chaindead/telegram-mcp_windows_arm64","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.14-SNAPSHOT-59a2970":{"name":"@chaindead/telegram-mcp_windows_arm64","version":"0.1.14-SNAPSHOT-59a2970","keywords":[],"_id":"@chaindead/telegram-mcp_windows_arm64@0.1.14-SNAPSHOT-59a2970","maintainers":[{"name":"chaindead","email":"miromaxxs@gmail.com"}],"os":["win32"],"bin":{"telegram-mcp_windows_arm64":"telegram-mcp.exe"},"cpu":["arm64"],"dist":{"shasum":"8799f73a3882747b0cf1a3fa1d371d5229bbbfe8","tarball":"https://registry.npmjs.org/@chaindead/telegram-mcp_windows_arm64/-/telegram-mcp_windows_arm64-0.1.14-SNAPSHOT-59a2970.tgz","fileCount":4,"integrity":"sha512-2NVlTKP3rYPEuXPmXv3kvRL2IaKbGZoMFadA0IAoMhKdTkfdeeP6P87QuhBJLN0K6CZP9ddOAluScljH8QsDqw==","signatures":[{"sig":"MEQCIE/wGJuQ/LeBeXi7gMjLv+peP1VgQG3MR7kWmhEDrNfKAiBrTa10eTHW5i51zdk/YFQlXoEKtkhsa1MnNgEGqOdTtA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34093965},"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_arm64_0.1.14-SNAPSHOT-59a2970_1744139130519_0.35471533094023977","host":"s3://npm-registry-packages-npm-production"}},"0.1.21":{"name":"@chaindead/telegram-mcp_windows_arm64","version":"0.1.21","keywords":[],"_id":"@chaindead/telegram-mcp_windows_arm64@0.1.21","maintainers":[{"name":"chaindead","email":"miromaxxs@gmail.com"}],"os":["win32"],"bin":{"telegram-mcp_windows_arm64":"telegram-mcp.exe"},"cpu":["arm64"],"dist":{"shasum":"09405988aec60e8142967247023dd63f3a749af2","tarball":"https://registry.npmjs.org/@chaindead/telegram-mcp_windows_arm64/-/telegram-mcp_windows_arm64-0.1.21.tgz","fileCount":4,"integrity":"sha512-V7d1q7vZh1eLFxI2uolAT3aNOjS/k4es4EBwSrnUIhNfJsNw54vSQ4CBKMCLXi/sSNkFEz1I/KwoR25IppBPRg==","signatures":[{"sig":"MEYCIQDPKDGGbBTE+/qQhhYT3sHBdhxFfiFu+1KKm3fKwHW8ogIhANUCsI3DE3H+/jBV4X4W3a6bzM964xLg/xVhIxJ2Yo7t","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34078765},"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_arm64_0.1.21_1744139966924_0.5358290339044094","host":"s3://npm-registry-packages-npm-production"}},"0.1.22":{"name":"@chaindead/telegram-mcp_windows_arm64","version":"0.1.22","keywords":[],"_id":"@chaindead/telegram-mcp_windows_arm64@0.1.22","maintainers":[{"name":"chaindead","email":"miromaxxs@gmail.com"}],"os":["win32"],"bin":{"telegram-mcp_windows_arm64":"telegram-mcp.exe"},"cpu":["arm64"],"dist":{"shasum":"9da898244cb02088a5a07b89795cecb39cb2dd54","tarball":"https://registry.npmjs.org/@chaindead/telegram-mcp_windows_arm64/-/telegram-mcp_windows_arm64-0.1.22.tgz","fileCount":4,"integrity":"sha512-cho2AHduiOcpf6JC1guV0TEfDtFUZk3asMWJ19NRZYVJkTDiZEafaSuJBkGzr/lMgkdCjfVoZWIiiHcAXl8drA==","signatures":[{"sig":"MEYCIQC2QxyJqAYFDlaUr1icA+sDxxIJSPtrJpgkSVonedYEAAIhALzX1cxG/waFLC+5X6NHI4A/m8vLRl2v/Hx6tUA7PrLn","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34088771},"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_arm64_0.1.22_1744926621678_0.8933796291876053","host":"s3://npm-registry-packages-npm-production"}},"0.1.23":{"name":"@chaindead/telegram-mcp_windows_arm64","version":"0.1.23","keywords":[],"_id":"@chaindead/telegram-mcp_windows_arm64@0.1.23","maintainers":[{"name":"chaindead","email":"miromaxxs@gmail.com"}],"os":["win32"],"bin":{"telegram-mcp_windows_arm64":"telegram-mcp.exe"},"cpu":["arm64"],"dist":{"shasum":"a57a72c4ea2ebbba7ffc6a17b0d101f6ddc3d40b","tarball":"https://registry.npmjs.org/@chaindead/telegram-mcp_windows_arm64/-/telegram-mcp_windows_arm64-0.1.23.tgz","fileCount":4,"integrity":"sha512-7Hqls+8i6wNYfNqg8aTD67BXeDTwbFXzuC07dVjecpvc6MnEqnji8dUB/WHQryubNij01v54loop1wvAxGbvRw==","signatures":[{"sig":"MEQCIHNvflJpNVYugNx7cIqPym545vXkOyR8QOQzaFpwJEyIAiAeFIPtBf6T1mM8aSQnfDJIgaA4KRXm0Tr111POp9IaYw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33575235},"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_arm64_0.1.23_1755773391754_0.0016329876010556799","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@chaindead/telegram-mcp_windows_arm64","version":"0.2.0","bin":{"telegram-mcp_windows_arm64":"telegram-mcp.exe"},"os":["win32"],"cpu":["arm64"],"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_arm64@0.2.0","gitHead":"1c2c03a79204f388ede69835a0c181bbf58b510e","_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-3M7CW+bV3xeeMk9iNuF/UthvgZ+OI93whThLHKg9F4faem2+wHnNygeunlDrDncqKkFrR7PXc+1oMcU3b7KrDw==","shasum":"7048a7ec9cfbb94585838bb2f170750a9acf6054","tarball":"https://registry.npmjs.org/@chaindead/telegram-mcp_windows_arm64/-/telegram-mcp_windows_arm64-0.2.0.tgz","fileCount":4,"unpackedSize":35795790,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDPycndLih4ttIX2z/+7sJGIMoVryKujG3TtNA8yD5g9wIhAKVdMb6yWLdiZ+3YqrQazkJkK/woxHUMO8MrFoeWguxc"}]},"_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_arm64_0.2.0_1772228219967_0.15317385138464568"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-08T19:05:30.455Z","modified":"2026-02-27T21:37:00.612Z","0.1.14-SNAPSHOT-59a2970":"2025-04-08T19:05:30.954Z","0.1.21":"2025-04-08T19:19:27.357Z","0.1.22":"2025-04-17T21:50:22.008Z","0.1.23":"2025-08-21T10:49:52.053Z","0.2.0":"2026-02-27T21:37:00.501Z"},"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"}