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 November 15, 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, select Sign In and 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 marks its MCP page Pro Exclusive, and that page covers Desktop (macOS and Windows) and iOS (as of November 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 marks MCP Pro Exclusive, and Pro starts with a 7-day free trial (Pro+ and Max have no 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. Pro+ replaced the old Advanced AI add-on; Raycast's pricing table lists it as Plus (as of November 2026).

Adding the server

Run the Install MCP Server command (or use the Install New Server action inside Manage MCP Servers) 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. (Static is for servers that make you register your own client ID and secret.)

Description and Custom Instructions are optional. Press Install MCP Server (⌘ ↵ on macOS, Ctrl ↵ on Windows).

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

For HTTP servers with OAuth, Raycast asks you to Sign In before any tools become available. Select Sign In and Raycast registers itself with the server and opens the consent screen in your browser. Sign in if asked, review, and approve, and Raycast pulls in the server's tools. Raycast stores the tokens encrypted, per server.

If a sign-in doesn't finish, use the Reset Sign In action to retry without reinstalling the server.

Using it

@-mention the server's name in AI Chat or Quick AI to bring its tools into the conversation. Raycast also adds an Ask command for each installed server to Root Search (for example, Ask Linear), which opens Quick AI with that mention filled in.

To review, reauthorize, or remove the server later, run the Manage MCP Servers command. It shows each server's status (Running, Stopped, or Error) and its tools, and Logout Server clears saved tokens without removing the server.

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 Account Avatar → AI → MCP Servers, tap the plus icon, 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. If a sign-in expires on iOS, you can reconnect the server from Settings (iOS v1.5.4, November 2026).

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 server shows an Error status. Open Manage MCP Servers — since v2.9 (October 2026) it shows the connection error details for each server, which usually names the problem directly.
  • 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. Select Sign In on the server, or use Reset Sign In to start over. Then 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.
  • The connection times out. Update Raycast. Version 2.10 (October 2026) fixed timeouts with servers that use streaming HTTP responses.

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:

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, Raycast asks you to Sign In before the server's tools become available. Select Sign In, sign in and approve on the server's consent screen in your browser, and Raycast pulls in the server's tools. If a sign-in stalls, the Reset Sign In action lets you retry without reinstalling the server.
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.