A Telegram MCP server on your own account.
telemcp is a Telegram MCP server that connects your AI agent to your own Telegram account, not to a bot. It is for people who already run an agent and want it to answer their private chats. It is open source and runs on your own machine. No price is published.
You run the server, the Telegram session and any storage yourself. Nothing goes through our servers. Would rather not run it? A hosted version on mcp.telemcp.com is planned as the paid option. It is not live and has no price yet.
One mail when the code is public. Nothing else.
Plate 1Jonas lets his agent answer the people who write to him on Telegram. Jonas is an example, not a customer.
Chats
Plate 2Example chats. Jonas and the people writing to him are examples, not customers.
Four chats waited until six.
The problem is not Telegram. It is that the one person who can answer is busy.
Jonas runs a small video studio and talks to clients on Telegram. On a shoot day his phone stays in his bag. At 17:58 he opens it and four people are waiting: a quote request from the morning, a question about a delivery date, a file that did not open, and a client asking if Thursday still works. None of it was hard. All of it sat for hours.
The bot route does not fix it. A bot made with BotFather is a separate account. People have to find it and message it, and it never sees the chats that arrive in your own inbox. telemcp is built for the other case: your own account, the chats you already have. His agent answers from his account, so the people writing to him see a message from Jonas.
Set up in three steps.
The code is not public yet. Here is how it fits together; the exact install lines come in the repo README.
Run it on your machine.
telemcp is a server you run yourself, next to the agent you already use. The Telegram session and anything it stores stay on that machine, and we do not see your chats. The self-hosted build needs no account with us. Install steps, the licence and the run command ship with the repo, and we will not guess at them here.
The telemcp repo is public
Hi Jonas,
The code is public. This is the one mail you asked for.
https://github.com/••••••••••your own machineThe README has the install steps, the licence and the run command.
Plate 3Example of the one mail you get when the code is public. Jonas is an example, not a customer.
Sign in as you.
telemcp signs in to your own Telegram account, not a bot account. The exact sign in steps for the self-hosted build will be in the README.
This code can be used to log in to your Telegram account. We never ask it for anything else.13:38
Plate 4Example sign in screen. The code 61382 is an example.
Brief your agent.
Tell your agent who you are, how you write and what it may answer. Your agent decides what to say.
Plate 5Example brief. Names in it are examples, not customers.
Want the link when the repo is public?
One mail with the GitHub link. If you would rather not run it yourself, we will also tell you when the hosted version opens.
What it does, in one chat.
The jobs your agent does on your own Telegram account.
Your agent sees the messages people send you in the private chats on your own account.
Replies go out from your account, not from a bot. The person on the other side sees a message from you.
What your agent writes is what gets sent. If a reply is wrong, the brief your agent follows is where to fix it.
Plate 6An invoice question answered in one chat. Priya and Tomasz are examples, not customers.
What it will not do.
Some limits come from Telegram, some from how telemcp is built. Numbers for the self-hosted build will be documented with the repo, so there is no numbers table on this page yet.
Logs out all devices except for this one.
Plate 7Settings, Devices in Telegram, where you can end the session.
The planned hosted version answers people who wrote to you and nobody else. Answering people who write to you is also the safe way to use a personal account, whichever build you run.
Telegram decides what happens to an account. When Telegram asks an account to slow down, the hosted engine pauses sends. When Telegram flags an account for messaging too many strangers, sending stops on that account. We cannot promise Telegram will never restrict an account, and we do not.
Open Telegram, go to Settings, Devices, and end the session. That works for any login, wherever the server runs. On the hosted version you can also ask your agent to disconnect.
Three more chats.
The kind of message that waits for hours when you are busy.
Plate 8Henrik, a returning client, asks whether last month's price still stands. The agent reads the earlier messages in the chat and answers with what the brief says. Henrik is an example, not a customer.
Plate 9Elif asks to move a call to next week. The agent offers the slots the brief allows and leaves the booking to you. Elif is an example, not a customer.
Plate 10Amaka writes in because a course link will not open. The agent sends the right link in one message. Amaka is an example, not a customer.
Who it is for.
Right now, people who can run a local server. Later, everyone else through the hosted version.
You already have an agent on your machine and want it on your Telegram as you, not as a separate bot your contacts have to find.
The self-hosted build runs on your machine, and your messages never pass through our servers.
Clients write to your personal account, not to a bot. If running a server is not your thing, the hosted version on mcp.telemcp.com is for you. It is planned, not live, and has no price yet.
Your agent answers the people who wrote to you, in your voice, and leaves the rest to you.
Asked before you install.
Short answers to what people ask when they look for a Telegram MCP server.
What is a Telegram MCP server?
It is a server that lets an AI agent such as Claude Code, Codex or OpenClaw use Telegram through the Model Context Protocol. telemcp is one that connects the agent to your own Telegram account, so it can read your private chats and answer as you.
Is there a Telegram MCP server that uses my own account, not a bot?
Yes, that is what telemcp is for. It signs in to your own Telegram account, so people get messages from you. A bot made with BotFather is a separate account that people have to find, and it never sees your own inbox.
How is telemcp different from a Telegram bot plugin for Claude Code?
A bot plugin talks through a bot you create, and only people who open that bot can reach it. telemcp works on your personal account, in the private chats you already have, so your agent answers the people who already write to you.
Is telemcp open source, and where does it run?
It is open source and runs on your own machine: you run the server, the Telegram session and any storage. The repo is not public yet; leave your email on this page and you get the link when it is.
Does telemcp send my messages through your servers?
No. The self-hosted build never talks to our servers. A hosted version on mcp.telemcp.com is planned for people who do not want to run it themselves, and it is not live yet.
How much does telemcp cost?
No price is published. The hosted version on mcp.telemcp.com is planned as the paid option for people who do not want to run it themselves; it is not live and has no price yet.
Is telemcp made by Telegram?
No. Telegram is a trademark of its owner, and telemcp is not affiliated with it.
Will Telegram ban my account if an AI agent uses it?
We cannot promise it never will. On the engine behind the planned hosted version, sends pause when Telegram asks the account to slow down, and sending stops if Telegram flags the account for messaging too many strangers. Answering people who write to you is the safe way to use it.
Can my agent message people who never wrote to me on Telegram?
Not on the planned hosted version: it only messages people who have written to that Telegram account, and starting a chat with someone new is not available. The self-hosted build will document its own rules in the repo.
Does telemcp work with Telegram groups and channels?
The planned hosted version handles private chats only. The self-hosted build will document what it supports in the repo README.
How do I disconnect telemcp from my Telegram account?
Open Telegram, go to Settings, Devices, and end the session. That works for any login, wherever the server runs.
Your Telegram, answered. Still yours.
Open source, on your own machine, signed in as you. No price is published. The repo link goes out by email when the code is public.
A hosted version on mcp.telemcp.com is planned for later.
AppendixThe setup lines. For your MCP client, shipped with the repo.
telemcp is an MCP server, so connecting it to your agent is a few lines of config. Those lines, the run command and the list of tools the server exposes will be in the repo README. They are not on this page yet because the repo is not public, and a setup line that does not match the code is worse than none. Leave your email above and the link comes in one mail.