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
claude mcp add raycast -- npx -y raycast-mcp-serverWhat 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-routinewith three steps, then execute it. - Validate
GITHUB_TOKENwithraycast_authand tell me whether it works.
How to install raycast
Platform CLI
claude mcp add raycast -- npx -y raycast-mcp-serverPlatform CLI
codex mcp add raycast -- npx -y raycast-mcp-serverConfig file
{
"mcpServers": {
"raycast": {
"command": "npx",
"args": [
"-y",
"raycast-mcp-server"
]
}
}
}Config file
{
"servers": {
"raycast": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"raycast-mcp-server"
]
}
}
}Platform CLI
gemini mcp add raycast npx -y raycast-mcp-serverStep 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.