← All Telegram MCP connectors

n8n · n8n.io

n8n Telegram MCP — automate your real account

Add Entergram as an MCP data source in n8n and automate your real Telegram account — flag the messages you missed, chase the leads that went cold, and route client feedback wherever it needs to go.

MCP server URL https://mcp.entergram.com/mcp

n8n's MCP node talks to any external MCP server. Pointed at Entergram, it turns your real personal Telegram account into a trigger-and-action source for visual workflows — all over OAuth, with no bot token and no custom code to write.

Paste-ready configuration

n8n → MCP node → Server URL
https://mcp.entergram.com/mcp

Automations worth building

With your personal account connected, n8n can watch and act on your chats. For example:

  • Every morning at 08:00, open a ticket for any client message left unanswered overnight.
  • When a webhook fires, post the deployment status to the customer channel.
  • Nightly, tag chats mentioning cancellation so the retention team sees them.
  • When a ticket closes, send the requester a follow-up asking for feedback.
  • Hourly, sync new Telegram contacts into the CRM columns your pipeline uses.
  • On a schedule, summarize the day's chats and mail the digest to your team.

Connect n8n in 3 steps

Works with the n8n MCP node.

  1. 01

    Copy your MCP URL in Entergram

    In Entergram, head to Settings → Workspace → Connectors → MCP and copy the endpoint. n8n stores it on a credential, so you paste it once and every later workflow reuses it.

  2. 02

    Add the MCP node in n8n

    In your n8n workflow, add the MCP node and point it at the Entergram MCP URL: https://mcp.entergram.com/mcp.

  3. 03

    Authorize and build

    Click Connect, log in with your Entergram account, and click Allow access, then wire Telegram triggers and actions into your n8n scenarios.

Three ways to run Entergram inside n8n

n8n Cloud

The shortest path. Drop an MCP Client node into a workflow, paste the hosted endpoint, and let n8n Cloud handle the OAuth round-trip on its own callback domain — there is no tunnel to open and no certificate to manage. Because the Entergram server is remote, the node holds a credential rather than spawning a local process, so the same workflow runs identically on every execution worker and survives being exported and imported into another project.

Self-hosted n8n

Same node, one extra prerequisite: the OAuth handshake redirects back to your instance, so n8n has to know its own public address. Set the host and webhook variables before you create the credential, otherwise the consent screen completes and then bounces to localhost. Everything after that behaves the same as Cloud, including credential sharing across projects.

N8N_HOST=n8n.yourcompany.com
N8N_PROTOCOL=https
WEBHOOK_URL=https://n8n.yourcompany.com/

AI Agent node with MCP tools

Instead of wiring each call by hand, attach the MCP client to an AI Agent node as a tool provider and let the model choose which Entergram tools to invoke for a given input. This suits fuzzy jobs — classifying an inbound message, deciding whether something deserves a ticket — where the branching logic is easier to describe than to draw. Pin the tool list you actually want exposed; an agent with seventy tools available will occasionally take a scenic route, and a scheduled agent should not have destructive tools within reach in the first place.

Six workflows that pay for themselves

n8n does not chat with your Telegram account, it schedules against it. Each row below is a real workflow shape: the trigger and goal on one side, the ordered Entergram calls that satisfy it on the other, and what lands in your systems when the run finishes. All of them run whether or not anyone has the tab open, which is the whole reason to build here instead of in a chat client.

The workflow

Nightly at 02:00, mirror every workspace chat and its pipeline fields into Postgres for the BI dashboard.

Tools called

entergram_list_workspace_chatsentergram_list_custom_columnsentergram_get_chat_custom_fields

The run produces

A Schedule Trigger fans the chat list into a Loop Over Items node, reads the column schema once so keys are resolved rather than guessed, then upserts a row per conversation. Your analysts query Telegram pipeline state in SQL the next morning without anyone touching Entergram.

The workflow

When CI posts a deploy-finished webhook, notify the customer groups affected by the release.

Tools called

entergram_list_groupsentergram_send_message

The run produces

A Webhook node receives the build payload, a Code node maps service names to the group titles that care about them, and one send call fires per group. Release comms stop depending on whoever remembers to paste the changelog, and because the message is composed from the build metadata it always carries the version that actually shipped.

The workflow

Hourly, close any ticket whose underlying conversation has been silent for seven days.

Tools called

entergram_list_ticketsentergram_list_messagesentergram_update_ticket

The run produces

The workflow pulls open tickets, checks the timestamp of the last message on each linked thread, and filters on age with an IF node before writing the status change. Stale queue items disappear on their own, and the ones that get a reply after closing simply reopen on the next inbound message.

The workflow

On a payment-failed event from your billing provider, open a dunning ticket with the invoice details attached.

Tools called

entergram_list_contactsentergram_create_ticketentergram_create_ticket_comment

The run produces

Contact lookup matches the payer to a Telegram conversation, the ticket is created against that chat, and the raw invoice payload goes in as a comment so the agent who picks it up has the amount and failure reason without opening the billing console. Dunning becomes a queue item with context attached rather than an email nobody owns.

The workflow

Every Sunday, reconcile Telegram group membership against the HR roster and remove people who have left.

Tools called

entergram_list_groupsentergram_list_group_membersentergram_remove_chat_member

The run produces

A Merge node diffs the two member lists and only the removals flow onward. Offboarding stops leaving ex-contractors sitting in client groups for months, and the run summary doubles as an access-review artefact for your auditor.

The workflow

Every fifteen minutes, forward invoices and contracts that clients dropped into chat to the finance channel.

Tools called

entergram_list_messagesentergram_get_messageentergram_forward_messages

The run produces

The polling branch scans recent history for document attachments, a Filter node keeps the ones matching your naming rules, and the forward preserves the original sender attribution. Finance stops asking whether the signed PDF is still sitting in someone's DMs.

What n8n can do with your Telegram

  • Trigger Telegram actions from any node in a workflow
  • Run unattended on a cron schedule or an inbound webhook
  • Open tickets automatically when a condition is met
  • Enrich CRM fields from data another node produced
  • Route messages conditionally with n8n's branching logic
  • Feed real chat history to an AI Agent node as a tool

The tool surface your workflows can call

One authorized credential exposes all 70 tools across 9 groups to every node that references it. In practice you will pin a handful per workflow — read tools in the polling branches, write tools behind a filter — but nothing here requires a separate integration or a second credential.

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

8 tools

Finding conversations. The workspace views carry CRM state (tickets, comments, custom fields); the live views carry current Telegram transport state and unread counts.

  • 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_get_chat_management

Messages

9 tools

Reading and writing message history, including edits, forwards and reactions. Sending is scoped per account, so nothing is global across your connected accounts.

  • entergram_list_messages
  • entergram_get_message
  • entergram_send_message
  • entergram_send_media_message
  • entergram_edit_message
  • entergram_delete_message
  • entergram_forward_messages
  • entergram_get_message_reactions
  • entergram_set_message_reactions

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

Authorizing a workflow, not a person

The credential you create in n8n keeps working long after you close the browser tab, which is exactly the point and exactly the risk. Decide up front whether this connection acts as one member or as the workspace, because unattended runs will keep exercising whatever you granted. Telegram session credentials stay inside Entergram; n8n only ever holds an OAuth token.

Personal agent
Available to any workspace member. It reads workspace, accounts, contacts, chats, messages and tickets, and it can read and write custom fields on chats belonging to you. A reporting or alerting workflow needs nothing more than this, and a credential that cannot send is a credential that cannot embarrass you at 3am.
Workspace connector
Restricted to owners and admins. This is the tier a sending workflow needs — outbound messages, custom-field writes across any chat, group administration — and it is shared with the team, so a colleague can maintain the automation without recreating the credential under their own name. Keep the sending workflows in a separate project from the reporting ones so the powerful credential is not attached to everything by default.
Revocation
Kill the token from Settings → Workspace → Connectors → MCP and every scheduled execution starts failing on its next call rather than silently continuing. Deleting the credential inside n8n has the same effect from the other direction. Revoke before offboarding whoever built the workflow, not after.

Constraints to design your workflows around

None of these are blockers, but each one changes how you build a node graph that runs unattended.

  • MCP access sits on the Pro plan. The credential authorizes on any tier, so the failure shows up later as tool errors inside a scheduled execution rather than at setup time.
  • MCP is request-response, not a push channel. Entergram does not open a socket into n8n, so an event-driven feel comes from a Schedule Trigger polling often enough — the trade-off is between latency and execution count.
  • Nothing approves a send for you. A chat client has a human reading each draft before it goes out; a cron job does not, so treat outbound branches as production code and gate them behind explicit filters and a test-mode flag.
  • There is no batch endpoint. Broadcasting to thirty chats is thirty separate calls, so pace the loop, keep retries bounded, and expect Telegram's own flood control to be the ceiling rather than the workflow.
  • A failed run is not atomic. If an execution dies halfway through a loop, the sends and field writes already committed stay committed — build the workflow to be idempotent and record what it processed rather than assuming a clean rollback.
  • Tokens expire. An automation that ran for weeks can stop overnight because nobody re-approved access, so add an error branch that alerts a human instead of failing into an empty log.

n8n connector troubleshooting

OAuth completes but redirects to localhost
A self-hosted instance that does not know its public address sends the callback to itself. Set the host, protocol and webhook variables to the URL your browser actually uses, restart n8n, then delete and recreate the credential — an existing one keeps the old redirect baked in.
The node connects but lists no tools
n8n caches the tool manifest when the credential is created. Reopen the node and refresh the tool list, or duplicate the node once; a workflow saved before the manifest loaded will keep referencing an empty set.
Read nodes work, send nodes return 403
That is a personal agent doing exactly what it is scoped to do. Outbound messaging belongs to a workspace connector, which an owner or admin has to create — reauthorizing the same personal credential will not widen it. If the 403 hits read nodes too, check the plan instead: MCP access requires Pro.
The workflow posts into the wrong Telegram account
Every message tool takes an explicit account_id, and an unspecified one is resolved for you. Call the accounts list once at the top of the workflow, pin the id you want as a workflow variable, and reference it in every downstream node.
A schedule that ran for weeks suddenly fails
Almost always an expired token. Open the credential, reconnect, approve access again, and the pending executions resume on the next tick. Wire the error output of the MCP node to a notification so the next expiry is not discovered by a client.
Executions time out on large message pulls
Reading full history for hundreds of threads in one node exceeds the execution timeout. Split the chat list with Loop Over Items, cap the batch size, and persist a cursor so each run picks up where the previous one stopped. A backfill should be a separate workflow from the incremental one that runs every hour.

n8n + Telegram FAQ

Does this replace the n8n Telegram node?
It complements it. The native Telegram node uses a bot token; Entergram connects your real personal account via MCP, so you can automate on chats a bot can’t see.
Self-hosted or cloud n8n?
Both. Any n8n instance with the MCP node can connect to the hosted Entergram MCP URL over OAuth.
Can it alert me about missed messages?
Yes. Build a workflow that reads unanswered chats on a schedule and sends you a digest or reminder wherever you want it.
Is it secure?
Yes. OAuth 2.0 with scoped permissions; credentials stay in Entergram and access is revocable anytime.

n8n Telegram MCP — automate your real account