Where in Raycast do I add an MCP server?

Open Raycast and run the Install MCP Server command, then fill in the form: give it a name, which becomes the at-mention handle, set Transport to HTTP, paste the server URL, and choose OAuth Type Dynamic. To review, reauthorize, or remove it later, run the Manage MCP Servers command.

What OAuth Type should I choose in Raycast?

Choose Dynamic when the server supports dynamic client registration, which means no client ID or secret is needed. When you click Install, your browser opens the server's consent screen; sign in and approve, and you return to Raycast with the server installed.

The at-mention doesn't autocomplete in Raycast AI Chat. How do I fix it?

Run the Manage MCP Servers command and confirm the server installed. The at-mention handle matches the name you gave during install, so if you named it something else, mention that exact name instead. If the server isn't listed at all, re-run the Install MCP Server command to add it again.

How to Add a Remote MCP Server to Raycast

How do I add a remote MCP server to Raycast?

Open Raycast, run the Install MCP Server command, and fill in the form: a name, Transport: HTTP, the server's URL, and OAuth Type: Dynamic. Click Install, approve in the browser, and the server is available by @-mention in AI Chat and Quick AI. There is no config file to edit. MCP is a Pro-tier feature as of August 2026 — Raycast's manual now labels the MCP page "Tier: Pro Exclusive" across Mac, Windows, and iOS. The free tier's role has narrowed to a trial: 50 free messages on Mac v1 and iOS, after which Raycast points you at Pro (which carries a 7-day free trial). Earlier in 2026, during the Mac v2/Windows beta, Raycast AI and MCP were usable without Pro — if you read that here before, it was true then; the beta pricing ended.

Requirements

Raycast on macOS or Windows (or the iOS app). A Raycast Pro subscription — the manual labels MCP "Tier: Pro Exclusive" as of August 2026. Pro includes a 7-day free trial, and 50 free messages on Mac v1 and iOS let you try Raycast AI first; the Advanced AI add-on is only about frontier-model access and higher limits, not MCP

Adding the server

Run the Install MCP Server command and fill in:

Name — this becomes the @-mention handle, so pick something you will want to type
Transport — HTTP
URL — the server's endpoint
OAuth Type — Dynamic, when the server supports dynamic client registration. That is what makes the setup keyless; no client ID or secret is needed.

Click Install.

The name field deserves a moment's thought. It is not a label — it is the handle you will type in every conversation, and renaming it later means retraining your own muscle memory.

Authorization

Your browser opens with the server's consent screen. Sign in if prompted, review, and approve. You are returned to Raycast with the server installed.

Using it

@-mention the server's name in AI Chat or Quick AI to bring its tools into the conversation.

To review, reauthorize, or remove the server later, run the Manage MCP Servers command.

iOS

Remote HTTP servers are the transport Raycast supports on iOS — its MCP documentation notes that iOS is always HTTP — so a hosted server is the kind that can work there at all, unlike a local stdio server.

iOS has its own add flow, documented separately from Desktop: tap your account avatar, then AI → MCP Servers, add the server with its name and URL, choose the OAuth Type, and save — Raycast connects, prompts the OAuth sign-in, and pulls the tool list. Installing on macOS does not carry the server to iOS automatically; add it on each platform.

That is still a real difference from editor-based clients, where the server is bound to that editor's install. Here the connection points at a hosted endpoint, so the phone can reach the same server rather than needing its own copy of it.

What usually goes wrong

The @-mention doesn't autocomplete. Run Manage MCP Servers and confirm the server installed. The handle matches the name you gave at install — if you named it something else, mention that exact name.
AI features aren't available at all. Check your plan first: MCP is Pro-exclusive as of August 2026. On Mac v1 and iOS the 50 free trial messages may simply be used up. Then check that you are on a supported platform and build, and whether you have hit the request limit for the period.
The OAuth window never appears. Re-run the install, and check pop-up blockers and your OS-level default browser setting.
The connection fails immediately. Check the URL against exactly what the server publishes, including the path and any trailing slash.

A worked example

Raycast is a launcher — its AI is always one keystroke away, which changes what a memory server is useful for. Instead of context that lives in one editor, it is context you can reach from anywhere on the machine.

Tempreon is a hosted MCP server built for exactly that shape. Install it with the name tempreon, Transport HTTP, OAuth Type Dynamic, and this URL:

https://api.tempreon.com/functions/v1/tempreon-mcp/mcp

Then @tempreon in AI Chat or Quick AI brings your context into the conversation, on the Mac and on your phone. The account-holder walkthrough is in the Raycast setup doc.