All MCP setup guides
MCPRaycast

How to Add a Remote MCP Server to Raycast

Raycast adds MCP servers through a single Install MCP Server command, with OAuth Type set to Dynamic. The name you choose becomes the @-mention handle, MCP comes with the paid plans, and HTTP is the transport iOS supports.

Last verified October 1, 2026

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. Install it, approve in the browser, and the server is available by @-mention in AI Chat and Quick AI. There is no config file to edit. Raycast AI, including MCP, comes with the paid plans (Pro, Pro+ and Max) — Raycast's manual labels the MCP page "Tier: Pro Exclusive" across Mac, Windows, and iOS (as of October 2026). Pro starts with a 7-day free trial that includes 500 AI credits.

Requirements

  • Raycast on macOS or Windows (or the iOS app), on a paid plan — Pro, Pro+ or Max. The manual labels MCP "Tier: Pro Exclusive", and Pro starts with a 7-day free trial. Any paid plan works for MCP: Pro+ and Max add top-tier models and more monthly AI credits, but Pro is enough to connect a server.

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.

Press Install MCP Server (⌘ ↵).

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. If Raycast doesn't open your browser right away, select Sign In when it prompts you — for HTTP servers with OAuth, Raycast asks you to sign in before any tools become available. Sign in if asked, review, and approve, and Raycast pulls in the server's tools.

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: Raycast AI and MCP come with the paid plans (Pro, Pro+ and Max), and a Pro trial lasts 7 days. Then check your AI credits in Settings → Account — a No Credits Left pill means this month's allowance is spent until it renews or you top up.
  • 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.

Sources

The dated claims on this page were checked against these vendor documents. Client UIs move constantly, so if one of these has changed since the date shown, trust the vendor over this page — and tell us.

Frequently asked questions

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. After you install, your browser opens the server's consent screen; if Raycast doesn't open it right away, select Sign In when it prompts you. Sign in and approve, and Raycast pulls in the server's tools.
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.