Raycast MCP Server: Power-User Guide to Setup, Sharing and Security

Last updated: November 20, 2026

The Raycast MCP server, added in Raycast 2.13 on November 18, 2026, turns Raycast into a local MCP server for agents such as Claude Code, Codex and Cursor. Turn it on under Settings, MCP, Raycast MCP Server, connect an app, and the agent can use your Notes, Clipboard History, Snippets and settings. It requires Raycast Pro.

Contents

What changed in Raycast 2.13

Raycast shipped version 2.13 on November 18, 2026 for both macOS and Windows. Its headline feature is Raycast MCP.

According to the release notes, a connected agent can search your Clipboard History, create Snippets and Quicklinks, work with browser tabs, history and bookmarks, start Focus sessions, change Raycast settings and remember things across chats. On macOS it can also manage apps and Auto Quit rules. Everything runs locally on your computer.

The same release added one-click setup for Claude Desktop, VS Code, Gemini CLI and GitHub Copilot alongside Claude Code, Codex and Cursor, plus example prompts with a copy button in the server settings.

MCP client vs. MCP server

Raycast already worked as an MCP client. The Raycast manual now describes MCP as working in both directions. This table compares them:

Aspect Raycast as MCP client Raycast as MCP server (new)
Direction External servers plug into Raycast AI Other AI apps plug into Raycast
Who uses the tools AI Chat, Quick AI and AI Commands Claude Code, Codex, Cursor, VS Code and others
Transport Stdio or HTTP (HTTP only on iOS) Local HTTP at 127.0.0.1:8267/mcp
Platforms Mac, Windows and iOS Mac and Windows
Approvals Raycast Permissions setting The connected app’s own approval prompts
Plan Pro Pro

How to connect an agent

These steps follow the Raycast MCP Server section of the manual:

  1. Update Raycast to version 2.13 or later on your Mac or Windows PC.
  2. Open Settings, then MCP, then Raycast MCP Server. The server is off by default on each device.
  3. Turn on the Raycast MCP Server switch.
  4. Open the Connect App menu and choose Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, GitHub Copilot or VS Code.
  5. For any other app, choose Other App…, select Copy Configuration, and paste it into that app’s MCP settings. The configuration includes a token unique to that app.
  6. Review Shared Extensions and switch off anything the agent should not touch.
  7. Test with an example prompt from the server settings, then check the result in Raycast.

If you use Claude Code with several projects, our Claude Code Projects guide explains how its context works, and our Claude Desktop release channels guide covers keeping the desktop app current.

What agents can access

The Shared Extensions setting controls which built-in AI Extensions connected apps can use. Per the manual, the available extensions are Applications (Mac only), Automations, Browser, Calculator, Calendar, Clipboard, Contacts, Dictation, Extension Development, File Search, Focus, Manual, Memory, Notes, Organizations, Quicklinks, Send Feedback, Settings, Snippets, Store and Weather.

Two details matter. Automations is off by default and must be turned on to share it. Shared Snippets, Quicklinks and Notes are also offered to connected apps as MCP resources, not only as tools. Extensions that are disabled in Raycast, restricted by your organization or unavailable on your platform are not shared.

Workflows and prompt patterns

Prompt patterns that map to the shared extensions:

  • Turn agent output into reusable assets: “Save the deploy command you just used as a Raycast Snippet called deploy-staging.”
  • Recover recent context: “Search my Clipboard History for the error message I copied in the last hour and explain it.”
  • Keep notes in one place: “Summarize this session’s decisions into my Raycast note named Project Log.”
  • Automate setup: “Create Quicklinks for our staging dashboard and issue tracker.” Raycast also says agents can change Raycast settings.
  • Protect focus time: “Start a 45-minute Focus session while you run the test suite.”

Security and approvals

The server only listens on your own computer, at http://127.0.0.1:8267/mcp, so only apps on that computer can reach it. Each connected app gets its own token, and the Connected Apps list lets you revoke any token without affecting the others.

The key caveat: Raycast does not ask for confirmation when a connected app calls a tool. It passes tool annotations to the app and relies on that app’s approval prompts. If your agent auto-approves tools, it could delete a note or change a setting without asking, so check its approval settings first.

For a related local-agent pattern, see our LM Studio Agent Remote Control guide. For another desktop agent with system access on a Mac, see our Gemini computer use on Mac guide.

Controls for Enterprise admins

The Raycast MCP Server Control page describes an Enterprise-only policy. Managers open Raycast Account Settings, then Organization, then AI Control Center. There they can turn the server off for everyone, or set MCP Server Extensions to Limited and choose an allow-list.

  • Default: enabled with all extensions allowed, but the server stays off on each computer until a member with Pro features turns it on.
  • When disabled: members cannot turn it on, and Raycast leaves its tools out of the tool list and refuses calls.
  • New extensions: with a Limited list, an extension added in a later release stays unavailable until a Manager allows it.
  • Multiple organizations: Raycast applies the strictest combination of each organization’s settings.

Teams standardizing agent tooling may also want our GitHub Copilot team plugins guide.

Plan availability and pricing

The manual states that the Raycast MCP Server is available with Raycast Pro. The Raycast Pro page lists Raycast MCP as a Pro feature, shows paid plans starting at $8 per month, and says the Free plan does not include AI. The free trial includes 500 credits of AI usage.

Raycast’s pages do not state whether tool calls from an outside agent use Raycast AI credits.

Limitations

  • Local only: agents on another machine, including cloud agents, cannot reach the server.
  • No iOS server: the manual lists the server for Mac and Windows only.
  • No built-in confirmation: safety depends on each connected app’s approval settings.
  • Built-in extensions only: the server shares Raycast’s built-in AI Extensions listed above.
  • Per-device setup: the server is off by default on each device.

Frequently asked questions

What is the Raycast MCP server?

It is a local Model Context Protocol server added in Raycast 2.13 on November 18, 2026. It lets AI apps on the same computer, such as Claude Code, Codex and Cursor, use Raycast’s built-in AI Extensions, including Notes, Clipboard History, Snippets, Quicklinks, Calendar and Settings.

How do I turn on the Raycast MCP server?

Open Settings, then MCP, then Raycast MCP Server, and turn on the switch. Use the Connect App menu to pick Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, GitHub Copilot or VS Code, or choose Other App and copy the configuration.

Does the Raycast MCP server need Raycast Pro?

Yes. Raycast’s manual says the Raycast MCP Server is available with Raycast Pro, and Raycast lists it as a Pro feature. The Free plan does not include AI. Raycast offers a free Pro trial for eligible new accounts.

Is the Raycast MCP server safe to use with coding agents?

It listens only on your own computer at 127.0.0.1 port 8267, and each connected app gets its own revocable token. However, Raycast does not ask for confirmation when a connected app calls a tool, so review the approval settings in each agent you connect.

Can my company turn off the Raycast MCP server?

Yes, on Enterprise plans. Managers can turn the server off for the whole organization, or limit which extensions it shares, from Organization and then AI Control Center in Raycast Account Settings. Members cannot override these settings.

Sources

Image: Raycast wordmark from the official Raycast Press & Media Kit, used for editorial purposes and placed on a dark background. Raycast is a trademark of its owner. FreeAnswers is not affiliated with or endorsed by Raycast.

Related answers

Leave a Comment