Telegram MCP server for Claude Code — provides wait_for_message and send_message tools
Project description
telegram-mcp
Telegram MCP server for Claude Code.
Tools
- wait_for_message — Blocks until a new Telegram message arrives (long polling internally)
- send_message — Send a message to a Telegram chat
Usage
uvx --from xbghc-telegram-mcp telegram-mcp
Claude Code .mcp.json
{
"mcpServers": {
"telegram": {
"command": "uvx",
"args": ["--from", "xbghc-telegram-mcp", "telegram-mcp"],
"env": {
"TELEGRAM_BOT_TOKEN": "${TELEGRAM_BOT_TOKEN}",
"TELEGRAM_ALLOWED_CHAT_ID": "${TELEGRAM_ALLOWED_CHAT_ID}"
}
}
}
}
Environment Variables
TELEGRAM_BOT_TOKEN(required) — Bot token from @BotFatherTELEGRAM_ALLOWED_CHAT_ID(optional) — Only accept messages from this chat ID. Other messages are silently ignored.http_proxy/https_proxy(optional) — Auto-detected for proxy support
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file xbghc_telegram_mcp-0.1.3.tar.gz.
File metadata
- Download URL: xbghc_telegram_mcp-0.1.3.tar.gz
- Upload date:
- Size: 3.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4b07efe4923b610036b32df6a2d857c67c8a6b888d136f3b42312e26f0109de4
|
|
| MD5 |
e0d32ec6ee6857fe7ec8ed8ff94bdfb1
|
|
| BLAKE2b-256 |
1311665b39b538c812d4e300ce81cb6b69802dcf9ae73ba7f07fcb6227ae444d
|
Provenance
The following attestation bundles were made for xbghc_telegram_mcp-0.1.3.tar.gz:
Publisher:
publish.yml on xbghc/telegram-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
xbghc_telegram_mcp-0.1.3.tar.gz -
Subject digest:
4b07efe4923b610036b32df6a2d857c67c8a6b888d136f3b42312e26f0109de4 - Sigstore transparency entry: 1056968320
- Sigstore integration time:
-
Permalink:
xbghc/telegram-mcp@61aa57a6bb1848ca3533b561c79a8ee6b2287e83 -
Branch / Tag:
refs/tags/v0.1.3 - Owner: https://github.com/xbghc
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@61aa57a6bb1848ca3533b561c79a8ee6b2287e83 -
Trigger Event:
push
-
Statement type:
File details
Details for the file xbghc_telegram_mcp-0.1.3-py3-none-any.whl.
File metadata
- Download URL: xbghc_telegram_mcp-0.1.3-py3-none-any.whl
- Upload date:
- Size: 4.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2bd7840c66ccc3731057bb52f5a660095acb7ff450731df1354ed5d950b5c393
|
|
| MD5 |
0b7ef6015d2b8c2c9c9944c3f2a9694f
|
|
| BLAKE2b-256 |
bf8159195daaa5a89dab5ba1d73f00339eeda5b39988f386adff5bd0165ca6d0
|
Provenance
The following attestation bundles were made for xbghc_telegram_mcp-0.1.3-py3-none-any.whl:
Publisher:
publish.yml on xbghc/telegram-mcp
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
xbghc_telegram_mcp-0.1.3-py3-none-any.whl -
Subject digest:
2bd7840c66ccc3731057bb52f5a660095acb7ff450731df1354ed5d950b5c393 - Sigstore transparency entry: 1056968323
- Sigstore integration time:
-
Permalink:
xbghc/telegram-mcp@61aa57a6bb1848ca3533b561c79a8ee6b2287e83 -
Branch / Tag:
refs/tags/v0.1.3 - Owner: https://github.com/xbghc
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@61aa57a6bb1848ca3533b561c79a8ee6b2287e83 -
Trigger Event:
push
-
Statement type:
