Simple MCP server to send you notifications on telegram
Simple MCP server to send you notifications on telegram. The telegram notification mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 4 defined tools rather than through you.
An MCP (Model Context Protocol) server that sends notifications to Telegram when Claude Code completes tasks. Built with TypeScript using the Cloudflare Agents SDK and deployable on Cloudflare Workers.
The server ships on npm as wrangler, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Everything the assistant can do here goes through one of these:
Prerequisites — The Prerequisites tool exposed by this serverInstallation — 1. Clone this repository 2. Install dependencies: bash pnpm installConfiguration — 1. Create a .dev.vars file from the example: bash cp .dev.vars.example .dev.vars Then edit .dev.vars with your bot token and chat ID. This file isDeployment — The Deployment tool exposed by this serverYou will need 2 environment variables: YOUR_BOT_TOKEN, DEFAULT_CHAT_ID. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Among the team communication options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Telegram Notification's toolset — Prerequisites, Installation, Configuration and 1 more — is a fair guide to whether it matches your workflow. It is maintained by kstonekuan; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Telegram Notification's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| Prerequisites | The Prerequisites tool exposed by this server. |
| Installation | 1. Clone this repository 2. Install dependencies: bash pnpm install |
| Configuration | 1. Create a .dev.vars file from the example: bash cp .dev.vars.example .dev.vars Then edit .dev.vars with your bot token and chat ID. This file is used for both local development and deployment. |
| Deployment | The Deployment tool exposed by this server. |
{
"mcpServers": {
"telegram-notification": {
"command": "npx",
"args": ["-y", "wrangler"],
"env": {
"YOUR_BOT_TOKEN": "your-value",
"DEFAULT_CHAT_ID": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| YOUR_BOT_TOKEN | Credential the server authenticates with. | Yes |
| DEFAULT_CHAT_ID | Configuration value read at startup. | Optional |
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Inbox intelligence — search, read, draft and send Gmail through your assistant with OAuth auto-setup.
Read and write Jira, Confluence, Bitbucket, JSM and Compass from your AI client — with your own permissions.
Read and send Telegram messages through your assistant — chats, channels and history via the client API.
Enables Discord bot integration with Model Context Protocol (MCP) compatible applications like Claude Desktop.
Exposes REST APIs defined by OpenAPI specifications as Model Context Protocol (MCP) tools, facilitating seamless integration into MCP-based workflows.