Skip to main content
MCP server CX Codex

raycast — MCP server for Claude Code: nine Raycast tools

raycast is an MCP server for Claude Code and other agents that exposes nine Raycast and macOS automation tools. It runs on a Mac with Raycast installed.

MIT ★ 7 updated 2026-11-13

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add raycast -- npx -y raycast-mcp-server
Open on GitHub

What raycast does

Nine tools cover search, command and extension URLs, clipboard, and window control. The agent can type a query into Raycast and fire the top hit, show or clear what is on the clipboard, hide or focus the app window. Two more handle selected macOS system actions and local workflows made of command, API and notification steps.

Calls go through execFile and spawn; nothing is passed into a shell. Strings from the user get length bounds, URL schemes come from an allowlist. Keyboard shortcuts rely on AppleScript, so the terminal or MCP host needs Accessibility permission. Without it those calls fail.

The auth tool reads environment variables and validates GitHub, Notion and Figma tokens while keeping the values out of the reply. Codes are never exchanged here and there is no callback endpoint. Consent links come from templates, so a working one needs your own client ID and a redirect URL of your own. Slack, Linear and Jira tokens are noticed but have no remote check. Node.js 18+ is required, plus Raycast on the Mac.

What it helps with

  • fire a Raycast search from an agent session and open the top hit
  • clear the clipboard before pasting code
  • save a morning routine as a reusable workflow and run it later
  • check GitHub and Notion tokens without printing them into the chat
  • hide or focus the Raycast window mid-task

Example prompts for the agent

  • Search Raycast for the GitHub extension and open the first result.
  • Store a workflow called morning-routine with three steps, then execute it.
  • Validate GITHUB_TOKEN with raycast_auth and tell me whether it works.

How to install raycast

Platform CLI

claude mcp add raycast -- npx -y raycast-mcp-server

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about raycast

How do I install raycast in Claude Code?

Run claude mcp add raycast -- npx -y raycast-mcp-server. That registers the server and starts it through npx.

What does raycast do?

It hands the model nine Raycast tools: search, command URLs, clipboard, window control, macOS system actions and local workflows.

What do I need to run raycast?

Node.js 18+, a Mac with Raycast installed, and Accessibility permission for the terminal or MCP host when AppleScript keyboard control is used.

Similar MCP servers

All MCP servers for Automation and no-code: n8n, Zapier, Make →

Project sponsors

Companies that keep this analytics open