# telegram-userbot MCP server

> Allows an AI agent to read, search, send messages, and react to chats using your own Telegram account via MTProto.

- Repository: https://github.com/sdaveas/telegram-userbot
- Page: https://hostedmcp.org/servers/sdaveas/telegram-userbot
- Transport: —
- Stars: 0
- License: MIT

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `MCP_HTTP_PORT` | no | no |  |
| `QR_PORT` | no | no |  |
| `REACTION_EMOJI` | no | no |  |

## Tools (11)

- `tg_list_chats`
- `tg_unread`
- `tg_search`
- `tg_read_chat`
- `tg_read_history`
- `tg_send_message`
- `tg_send_media`
- `tg_send_sticker`
- `tg_react`
- `tg_reactions`
- `tg_forward`

## FAQ

### Does this server use a browser to interact with Telegram?

No, it uses the MTProto protocol via GramJS to interact directly with Telegram without a browser or DOM scraping.

### Is this a bot account or a personal account?

This is a userbot that runs as your own personal account, not a standard bot account.

### How can I secure the HTTP endpoint for the MCP server?

You should always pair the HTTP transport with an MCP_TOKEN to ensure the endpoint is authenticated.

### Can I restrict which chats the AI agent can send messages to?

Yes, you can use the SEND_ALLOWLIST environment variable to restrict sending to specific chat titles.
