← All Telegram MCP connectors

Raycast · MCP

Raycast Telegram MCP — Telegram from a keystroke

Add Entergram as an MCP server in Raycast and reach your real Telegram account from a keystroke — check missed messages and waiting clients without opening Telegram.

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

Raycast adds MCP servers through its “Manage MCP Servers” command. Register Entergram's and Raycast AI can reach your real personal Telegram account from anywhere on macOS — OAuth-scoped, with no bot and no API keys to store.

Paste-ready configuration

Raycast → Manage MCP Servers → Add
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Ask Raycast about your Telegram

With your personal account connected, Raycast AI can check Telegram in a keystroke. Try:

  • “What was the last message from Acme?”
  • “Does this chat already have an open ticket?”
  • “Send Marta a note that I'm running ten minutes late.”
  • “What's this contact's plan tier and account owner?”
  • “Who owns ticket 412 right now?”
  • “Thumbs-up the last message in the launch thread.”

Connect Raycast in 3 steps

Works with Raycast AI on macOS.

  1. 01

    Copy your MCP URL in Entergram

    Open Entergram, then Settings → Workspace → Connectors → MCP, and copy the URL. Raycast asks for it inside the Manage MCP Servers command.

  2. 02

    Add the server in Raycast

    Run Raycast’s “Manage MCP Servers” command and add a server with the Entergram URL: https://mcp.entergram.com/mcp.

  3. 03

    Authorize and use

    Confirm the server, sign in when the browser opens, and allow access. From then on the connector answers from any Raycast hotkey.

Three ways to trigger it

Raycast AI Chat

The default path and the one to start with. Hit your Raycast hotkey, open AI Chat, refer to the Entergram server in the prompt so its tools are in play, and read the answer in the same window you opened. Nothing else on screen has to move, which is the entire point.

An AI Command on its own key

Take the question you ask twenty times a day — what is waiting on me right now — save it as an AI Command and bind a key to it. One keystroke from inside any app returns the answer. Add a placeholder argument and the same command accepts a client name you type as you invoke it.

Manage MCP Servers

Raycast keeps its server list behind the Manage MCP Servers command, and each entry is plain JSON. Worth knowing when you set the same thing up on a second Mac: paste the entry, run the login once, and every saved command works there without being rebuilt. It is also where you go when a command has quietly stopped seeing your workspace, since the list shows whether the server is still enabled at all.

Questions you fire mid-sentence

This is not where you run a forty-step job. It is where you get one fact in the two seconds before somebody finishes asking you for it. Each of these is a keystroke, two or three tool calls, and an answer short enough to read standing up — the tool chain matters only because it explains why the reply arrives that fast.

You ask

«What was the last thing Marco said to me, and did I answer?»

Tools called

entergram_list_chatsentergram_list_messages

You get

Two calls and one line back: the message, its timestamp, and whether the final turn in the thread was his or yours. This is the query worth putting on a key, because you need it while the person is still mid-question and the alternative is opening an app and scrolling in front of them.

You ask

«Is there an open ticket for Northwind right now?»

Tools called

entergram_list_chatsentergram_list_chat_tickets

You get

It resolves the account’s chat, pulls the tickets attached to it, and reports status and priority for anything still open. Enough to answer a customer live on a call, and enough to know whether you are about to file a duplicate of something a colleague opened an hour ago.

You ask

«Tell the standup group I am five minutes out.»

Tools called

entergram_list_accountsentergram_list_chatsentergram_send_message

You get

The one write most people put on a shortcut. It works out which connected account owns that group before sending, so the message arrives from you rather than from whichever account happened to sort first. This one needs a workspace connector — a personal agent reads the group fine and then stops at the send.

You ask

«What do we have on file for this contact — plan, owner, renewal date?»

Tools called

entergram_list_contactsentergram_get_chat_custom_fields

You get

The name resolves to a contact, then the CRM columns attached to their chat come back with the empty ones stripped out. Fired ten seconds before a call starts, it is the difference between opening with context and opening with a question whose answer was already written down.

You ask

«Who owns ticket 412, and when did they last touch it?»

Tools called

entergram_get_ticketentergram_list_members

You get

The ticket record carries an assignee id; the member lookup turns it into a name you recognise. Owner, status and last update come back on one line — which is the entire content of the message you would otherwise post in a team channel and then sit waiting on. Ask it twice in a day and you have replaced a small, recurring interruption for somebody else on the team.

You ask

«Thumbs-up the last message in the launch channel.»

Tools called

entergram_list_chatsentergram_list_messagesentergram_set_message_reactions

You get

A three-call acknowledgement that costs less time than switching windows. It finds the channel, takes the most recent message id from history, and sets the reaction. Useful precisely when you want a room to know you read something and you are in the middle of something you do not want to leave.

What Raycast can do with your Telegram

  • Answer a Telegram question in under a second
  • Fire from a global hotkey in any application
  • Check a contact's last message mid-meeting
  • Send a short reply without opening Telegram
  • See whether a chat already has an open ticket
  • React to a message without switching context

What sits behind the launcher

The connector hands Raycast the same 70 tools in 9 groups a full agent gets, even though a typical launcher question touches two or three of them. The breadth is worth having for the occasional odd request — a group’s member list, one ticket field, a contact’s shared communities — that would otherwise cost you two apps and a search box. In practice the discovery groups do most of the work, because almost every fast question starts by resolving a name into a chat or a contact before it can look anything up.

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

What a keystroke is allowed to do

You authorize once, in a browser window Raycast opens for you, and the token stays on that Mac. Entergram never passes your Telegram phone number or session credentials to Raycast, and none of this depends on the Telegram desktop app being installed, launched, or even logged in. A launcher shortcut is by definition easy to fire by accident, so the narrower access level is the sane default unless a specific command needs more.

Personal agent
What almost every single-user Raycast setup should be on. Any member can create one, and reads are generously scoped — chats, message history, contacts, tickets and the workspace around them — while the only writes it holds are custom fields on chats of your own. A hotkey fired by mistake looks something up and stops there — it has no path to a customer.
Workspace connector
Required the moment you want the send-a-quick-reply commands, and it also unlocks field writes on any chat plus group administration. Owners and admins create it. On a laptop that travels, weigh that scope against how easy the trigger is to hit.
Revoking from a shared Mac
Deleting the server from Raycast’s list stops it on that machine. If the machine is no longer in your hands, revoke the token in Entergram under Settings → Workspace → Connectors → MCP instead — that ends access regardless of what is still configured locally.

What a launcher will not do for you

Raycast is deliberately shallow, and these are the edges you will meet within the first week of living on the hotkey.

  • MCP tool calls need a Pro workspace on the Entergram side. The connection authorizes on any plan; the answers only come back on Pro.
  • Raycast AI is a paid Raycast tier. MCP servers are driven by Raycast’s AI features, so confirm your Raycast plan covers them before debugging why the tools never fire.
  • macOS only. There is no Raycast client to configure on Windows or Linux — the MCP URL is identical everywhere, but you will be pointing a different app at it.
  • Nothing polls in the background. The connector answers when asked and never the other way round: no push notification, no menu-bar badge, no nudge when a client writes while you are in a meeting.
  • Wide questions stop being fast. Anything urgent across the whole workspace walks a lot of chats and takes as long as that implies. Name a person, a group or a time window and it stays snappy.
  • Send commands fail on a personal agent. Those scopes stop before outbound messages, so a reply-from-the-launcher shortcut depends on a workspace connector, which sits behind owner or admin rights.

Raycast connector fixes

The Entergram tools never get used
Raycast only reaches a server the prompt actually refers to. Name the Entergram server in the AI Chat message, or bake that reference into the saved AI Command — otherwise the model answers from general knowledge and never touches your workspace at all.
There is no AI option anywhere in Raycast
MCP servers run through Raycast’s AI features, which sit on its paid tier. If AI Chat and AI Commands are missing from your install, that is a Raycast subscription question rather than something to fix on the Entergram side.
The server disappeared from the list after an update
Re-open Manage MCP Servers, re-add the entry and run the login once more. Keeping the JSON entry saved somewhere turns this into a ten-second fix, and it is the same snippet you would paste when setting up a second machine.
The hotkey answers, but slowly
The prompt was too wide. A question naming one chat, one contact or one day resolves in two or three calls; check everything walks the workspace. Split the broad version into its own command and leave the fast one on the key.
Reads work, sends come back with an error
You connected as a personal agent, whose scopes end before outbound messages. The workspace connector that a send command depends on has to be created by someone with owner or admin rights — every read-only command keeps working either way.
It asks me to sign in again
Tokens do not last forever. Trigger the connection from Manage MCP Servers, approve the consent screen once more, and every saved command resumes working without any of them being edited.

Raycast + Telegram FAQ

How do I add an MCP server to Raycast?
Use Raycast’s “Manage MCP Servers” command, add the Entergram MCP URL, and authorize via OAuth.
Is this a Telegram bot?
No. Bots can't read your existing conversations. Raycast queries your real account over a hosted MCP server, which is what makes an instant lookup useful.
Is it secure?
Yes. OAuth 2.0 with scoped permissions; your credentials stay in Entergram and access is revocable.
Do I need to open the Telegram app?
No. Raycast AI queries your account through the MCP server, so you can check missed messages and waiting clients from a keystroke without launching Telegram.

Raycast Telegram MCP — Telegram from a keystroke