Telegram Userbot MCP Server
by sdaveas
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TG_2FA | No | Two-step verification password for QR login. | |
| EXCLUDE | No | Chat titles to ignore in `watch` output. | |
| QR_BIND | No | QR login page bind interface. | 127.0.0.1 |
| QR_PORT | No | QR login page port. | 8791 |
| TZ_NAME | No | Timezone for message timestamps (defaults to system tz). | |
| ENV_FILE | No | Which env file to load. | .env |
| MCP_HOST | No | HTTP bind interface. | 127.0.0.1 |
| MCP_TOKEN | No | Bearer token for /mcp. Strongly recommended; without it the HTTP endpoint is unauthenticated. | |
| SEEN_FILE | No | Marker dedup state file. | ./tg-marker-seen.json |
| SELF_NAME | No | How your own messages are labelled. | ME |
| TG_API_ID | Yes | Required. Your Telegram api_id from https://my.telegram.org (API development tools). | |
| TG_SESSION | No | Inline session string instead of a file. | |
| NOTIFY_CHAT | No | Where marker notifications go; defaults to your own Saved Messages. | me |
| TG_API_HASH | Yes | Required. Your Telegram api_hash from https://my.telegram.org (API development tools). | |
| MARKER_FILTER | No | Regex; only matching text is forwarded. | |
| MCP_HTTP_PORT | No | HTTP transport port; empty = stdio. | |
| MARKER_MESSAGE | No | Notification body template, with {chat} {sender} {text} {msgId} placeholders. | |
| REACTION_EMOJI | No | The marker reaction emoji. | ✍️ |
| SEND_ALLOWLIST | No | Restrict tg_send_message to these chat titles. | |
| START_LISTENER | No | Set to 1 to attach the marker listener inside the MCP process. | |
| TG_SESSION_FILE | No | Where the session is stored. | ./session.txt |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues