Skip to main content

Hosted Telegram MCP

Telegram MCP server for every account you run

Connect Claude, ChatGPT, Grok, Gemini, Perplexity or another AI assistant to every Telegram account on your seat, with one login. Your AI can read chats, open tickets, fill in CRM fields and answer questions about your response times. Real personal accounts, not bots. Nothing to host, and no session string to store.

MCP server URL https://mcp.entergram.com/mcp
Works with
Claude· ChatGPT· Grok· Gemini· Perplexity· Cursor

Setup

Connect Telegram MCP in 3 steps

The menus differ by app. The steps do not.

MCP server URL https://mcp.entergram.com/mcp Copy
  1. In Entergram, open Settings, then Workspace, then Connectors, then MCP, and copy https://mcp.entergram.com/mcp

  2. Add a custom connector in Claude, ChatGPT, Grok or another MCP app and paste the URL.

  3. Click Connect, sign in with your Entergram account, check what the app asks for and click Allow access.

  4. Six things people ask for most, each with a prompt you can paste as it is.

Use cases

Fill in CRM fieldsYour AI reads the chat and writes what it learns into your custom fields.TryRead the new lead chats on @denis_sales and set the stage and budget fields.
Open and sort ticketsIt turns chats that need an answer into tickets. Next to your help desk's own MCP, it can sort them there too.TryOpen a ticket for every support question nobody answered yesterday.
Find and follow up leadsIt looks across every account at once and tells you which one owns each lead.TryWhich leads went quiet this week, and on which account?
Search Telegram liveIt finds people, groups and channels outside your workspace. It matches names and usernames, not message text, and it is rate limited to protect your accounts.TryFind public groups about iGaming affiliates that none of our accounts has joined.
Send a broadcast in each reader's languageIt reads each chat first, so every recipient gets the message in the language they write in.TryRead each chat, detect the language and send this update in it.
Answer questions about your numbersYour AI works it out from the raw message events, so you are not limited to fixed reports.TryWhich account had the slowest first reply this week?

AI apps

Works with the AI apps you already use

Each app has its own setup page. The URL and the sign-in are the same everywhere.

Claude

Anthropic

Settings → Connectors

Ask about every account in one chat, or schedule a weekly summary per account.

ChatGPT

OpenAI

Custom MCP connector

Research chats and prepare CRM updates. Needs a paid ChatGPT plan with Developer Mode.

Grok

SpaceXAI

Custom MCP connector

Add Entergram as a custom connector and ask about any account.

Cursor & IDEs

Cursor, Zed, Windsurf

MCP settings

Bring customer reports from Telegram into your editor, next to the code.

Gemini

Google

Gemini CLI · MCP

Use Entergram as a Telegram MCP server for Google Gemini and the Gemini CLI. One login gives Gemini OAuth-scoped access to every Telegram account you run, so it can surface missed messages, waiting clients and cold leads.

n8n

n8n.io

MCP node

Add Entergram as an MCP data source in n8n and automate every Telegram account you run through one login. Flag the messages you missed, chase the leads that went cold, and route client feedback wherever it needs to go.

Make.com

Celonis

MCP module

Wire Entergram’s MCP endpoint into your Make scenarios and automate every Telegram account you run through one login. Surface the messages you missed, chase leads that went cold, and route client feedback visually.

Perplexity

Perplexity AI

Connectors

Attach Entergram as an MCP connector in Perplexity and bring every Telegram account you run into your research with one login. Surface missed messages, waiting clients and cold leads without leaving Perplexity.

Goose

Block

config.yaml

Add Entergram as an MCP extension in Goose, Block’s open-source AI agent, and let it work every Telegram account you run through one login. It surfaces missed messages, chases leads that went cold, and acts on chats autonomously.

Raycast

Raycast

Manage MCP Servers

Add Entergram as an MCP server in Raycast and reach every Telegram account you run from a keystroke, with one login. Check missed messages and waiting clients without opening Telegram.

Cline

Cline (VS Code)

MCP settings

Register Entergram as an MCP server in Cline, the VS Code AI agent, and reach every Telegram account you run from your editor with one login. Catch missed messages and clients waiting on you without breaking flow.

opencode

SST

opencode.json

Add Entergram as an MCP server in opencode, SST’s open-source terminal AI agent, and let it work every Telegram account you run through one login. Surface missed messages, chase leads that went cold, and act on chats from the command line.

Notion MCP

Notion + Entergram

Two-server MCP workflow

Give one compatible client two explicit tool boundaries: Entergram MCP works with authorized personal Telegram accounts, while Notion MCP works only inside the separately authorized Notion environment.

Stripe MCP

Stripe + Entergram

Two-server MCP workflow

Give one compatible client two explicit tool boundaries: Entergram MCP works with authorized personal Telegram accounts, while Stripe MCP works only inside the separately authorized Stripe environment.

Slack MCP

Slack + Entergram

Two-server MCP workflow

Give one compatible client two explicit tool boundaries: Entergram MCP works with authorized personal Telegram accounts, while Slack MCP works only inside the separately authorized Slack environment.

Custom Apps

Any MCP client

OAuth + MCP URL

Any app that supports MCP connects with the same URL.

With your other tools

Telegram MCP with your CRM and help desk

Your AI reads the Telegram chat through Entergram and updates your CRM or help desk through that tool's own MCP. For HubSpot and Zendesk you can also skip the AI: Entergram has native integrations for both.

CRM

SalesforceHubSpotMicrosoft Dynamics 365Zoho CRMPipedrivemonday CRMFreshsalesSAP Sales CloudOracle SalesNetSuite CRMOdoo CRMCreatioSugarCRMCopperCloseInsightlyKeapamoCRMAttioHighLevel

Help desk

ZendeskIntercomFreshdeskJira Service ManagementServiceNowHelp ScoutGorgiasFrontZoho DeskSalesforce Service CloudHubSpot Service HubKustomerGladlyDixaRe:amazeLiveAgentKayakoHappyFoxHiverGroove

What it is

What is Telegram MCP?

MCP (Model Context Protocol) is how AI apps like Claude and ChatGPT connect to other tools. A Telegram MCP server lets your AI read your chats and act in them. Telegram does not publish an official one, so you either run an open-source server yourself or connect to a hosted one. Entergram's is hosted, and one connection covers every account on your seat.

  1. Sign in once with your Entergram account.

  2. Approve what the AI may do, and revoke it any time.

  3. One URL works in every AI app.

  4. Real personal accounts, not bots.

Multiple accounts

One Telegram MCP connection for multiple personal accounts

Most Telegram MCP servers connect one bot or one account. That works for a personal assistant. It stops working when your team runs sales, support and regional accounts, and you want one AI to see all of them.

Learn more

The hard part is keeping the accounts apart, not opening more of them. Every chat your AI reads comes with the account it belongs to, so a question like "which chats went quiet this week" comes back sorted by account, and a reply goes out from the account that owns the chat.

Your workspace rules still apply. The AI sees only the accounts on your seat and only the chats those accounts can see. If a teammate cannot see usernames, the AI on that seat cannot read around it either.

Hosted or self-hosted

Hosted Telegram MCP server, or one you run yourself

Most Telegram MCP servers on GitHub are code you run yourself, usually Python on top of Telethon. They are open source and Entergram is not. If you have one account and want to read every line, run one of those.

Learn more

Each of them needs an api_id, an api_hash and a session string per account, and a machine that stays on. With Entergram you add an account by scanning a QR code in Telegram, paste one URL into your AI app and sign in. No session string to store, and no bot token, because these are real personal accounts.

What each option asks of you

Self-hosted Telethon serverEntergram MCP
Accounts per serverUsually one. The few that handle several accounts still need a separate session string for each one.Every Telegram account connected to your seat, with the source account kept on each call.
Credentials you holdapi_id, api_hash and a session string, per account, stored and rotated by you.None. QR or phone login for the account, OAuth for the client.
Bot tokenRequired by the Bot API wrappers, which cannot message a person first.None. Real personal accounts, so outbound first contact works.
HostingYour machine, container or VPS, kept running and patched.Nothing to host. One hosted endpoint at https://mcp.entergram.com/mcp
Network identityWhatever IP the box has, shared by every account running on it.A dedicated proxy per account, assigned by Entergram and stable over time.
Pacing and rate limitsYours to implement.Telegram-aware pacing on sends, and live Telegram search is rate limited per account.
Access controlAnyone who can read the session file has the account.OAuth with 16 permission scopes, approved and revoked per client.

Run your own if you have one account and want the code. Use Entergram if you run several accounts and do not want a session string per account on a server you keep alive.

Reference

The 78 tools this MCP server exposes

One URL carries all of them. You can name one in a prompt when you want that exact action. Your AI app can only use the ones covered by what you approved.

Learn more
Show all 78 tools in 9 groups

Accounts & workspace

5 tools

Identity and scope discovery. Every message call needs an account_id from list_accounts first - an AI client that skips this step will address the wrong Telegram account.

  • entergram_get_me
  • entergram_list_accounts
  • entergram_get_workspace
  • entergram_get_member
  • entergram_list_members

Chats & discovery

11 tools

Finding conversations. The workspace views carry CRM state (tickets, comments, custom fields); the live views carry current Telegram transport state and unread counts, and live search reaches people, groups and channels outside the workspace. Assignment writes the same owner field your CRM boards filter on, and it does not create a ticket. A channel with direct messages turned on resolves to its private inbox, so a reply goes there and not to the public channel.

  • entergram_search_telegram
  • entergram_list_chats
  • entergram_get_chat
  • entergram_list_live_chats
  • entergram_get_live_chat
  • entergram_list_workspace_chats
  • entergram_get_workspace_chat
  • entergram_update_workspace_chat
  • entergram_update_workspace_chat_assignment
  • entergram_get_chat_management
  • entergram_resolve_channel_direct_chat

Messages

14 tools

Reading and writing message history, including edits, forwards and reactions. Sending is scoped per account, so nothing is global across your connected accounts. A broadcast sends one text to up to 50 recipients through one account, and a first message can go to a phone number without saving it as a contact. Media files download whole up to 20 MiB and in 5 MiB chunks above that. The event feed lists message metadata (no text) in cursor order, which is what an AI client computes response times and volumes from.

  • entergram_list_messages
  • entergram_get_message
  • entergram_send_message
  • entergram_send_message_by_phone
  • entergram_broadcast_message
  • entergram_send_media_message
  • entergram_edit_message
  • entergram_delete_message
  • entergram_forward_messages
  • entergram_get_message_reactions
  • entergram_set_message_reactions
  • entergram_fetch_media
  • entergram_fetch_media_chunk
  • entergram_list_events

Contacts

3 tools

Who you are talking to, and where else you overlap with them. Shared-groups lookup is what makes questions like “which of my leads are in the same community?” answerable.

  • entergram_list_contacts
  • entergram_get_contact
  • entergram_list_contact_shared_groups

Tickets

10 tools

Full support-desk control: open, assign, prioritise, comment and close. Tickets link back to the chat they came from, so an AI client can move from conversation to queue in one step.

  • entergram_list_tickets
  • entergram_get_ticket
  • entergram_create_ticket
  • entergram_update_ticket
  • entergram_delete_ticket
  • entergram_list_chat_tickets
  • entergram_list_ticket_comments
  • entergram_create_ticket_comment
  • entergram_update_ticket_comment
  • entergram_delete_ticket_comment

CRM custom fields

11 tools

Your pipeline schema. Read the columns before writing values - checkboxes take booleans, multiselects take arrays of option values, dates take ISO 8601 strings.

  • entergram_list_custom_columns
  • entergram_get_custom_column
  • entergram_create_custom_column
  • entergram_update_custom_column
  • entergram_delete_custom_column
  • entergram_list_custom_column_options
  • entergram_create_custom_column_option
  • entergram_update_custom_column_option
  • entergram_delete_custom_column_option
  • entergram_get_chat_custom_fields
  • entergram_patch_chat_custom_fields

Ticket custom fields

9 tools

The same schema control for the ticket side - categories, severities, SLA tiers and anything else your desk tracks beyond status and priority.

  • entergram_list_ticket_custom_columns
  • entergram_get_ticket_custom_column
  • entergram_create_ticket_custom_column
  • entergram_update_ticket_custom_column
  • entergram_delete_ticket_custom_column
  • entergram_list_ticket_custom_column_options
  • entergram_create_ticket_custom_column_option
  • entergram_update_ticket_custom_column_option
  • entergram_delete_ticket_custom_column_option

Internal notes

4 tools

Comments on a chat that your customer never sees. Useful for letting an AI client leave its reasoning behind for a human teammate to pick up.

  • entergram_list_chat_comments
  • entergram_create_chat_comment
  • entergram_update_chat_comment
  • entergram_delete_chat_comment

Groups & channels

11 tools

Creating and administering Telegram groups and channels - membership, permissions, privacy and info - plus a raw command escape hatch for the rest.

  • entergram_list_groups
  • entergram_get_group
  • entergram_list_group_members
  • entergram_create_group_chat
  • entergram_create_channel
  • entergram_invite_chat_members
  • entergram_remove_chat_member
  • entergram_update_chat_info
  • entergram_update_chat_permissions
  • entergram_update_chat_privacy
  • entergram_run_chat_command
Show all 16 permissions
workspace.read Workspace details Read workspace name and configuration
members.read Team members View workspace member list
accounts.read Connected accounts Read connected Telegram accounts
contacts.read Contacts Access contact profiles and data
chats.read Chats Read conversation lists and metadata
chats.write Edit chats Update chat state and perform actions
chat_custom_fields.read Chat custom fields Read the field values on chats, without the column setup
chat_custom_fields.write Edit chat custom fields Update the field values on chats, without changing the column setup
messages.read Messages Read message history in authorized chats
messages.write Send messages Send messages through connected accounts
tickets.read Tickets Read support ticket data
tickets.write Edit tickets Create and update tickets
custom_fields.read Custom fields Read custom field columns, options and values
custom_fields.write Edit custom fields Create and edit custom field columns, options and values
events.read Read events Read the message event feed: metadata only, no message text
offline_access Stay connected Maintain connection without re-authenticating

FAQ

Telegram MCP FAQ

Can Telegram MCP connect multiple personal Telegram accounts?
Yes. One connection covers every personal account on your seat, and a workspace holds 100+ accounts. Every answer says which account a chat belongs to, so chats never get mixed up.
Does Telegram have an official MCP server?
No. Telegram does not publish one. Every Telegram MCP you find is either an open-source project you run yourself or a hosted service. Open-source servers run on a bot token or on a session string you create and store, one per account. Entergram is hosted and connects every personal account on your seat with one login.
Is my data safe?
Your AI app signs in with your Entergram account and asks for specific permissions, which you see before you approve. It only reaches chats your accounts can already see, and you can revoke access at any time.
Do I need a paid plan?
Yes. MCP comes with the Pro plan and above, not with Basic. Every AI app you connect runs on that one plan, with no fee per call. Some AI apps have their own requirement: ChatGPT needs a paid ChatGPT plan with Developer Mode turned on.
What does the Entergram MCP not do?
It does not use bots, so it never asks for a bot token. It is hosted and not open source, so there is no server for you to run or read. It reaches only the chats your accounts can already see, so it cannot open a private group an account was never admitted to. Live search matches names and usernames, not message text, and it is rate limited to protect your accounts.
Can I connect several AI apps at once?
Yes. Connect each one separately, so you can see and revoke each app's access on its own.
What happens if I revoke access?
The app can no longer reach your Telegram through Entergram. Anything it already saved follows that app's own data policy.

Software tailored to Telegram

Connect your AI to every Telegram account you run

MCP comes with the Pro plan. Try Entergram free for 3 days, no credit card.

Questions? Reach out: hello@entergram.com