# raycast

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: ExpertVagabond
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ExpertVagabond/raycast-mcp-server
- Updated: 2026-11-13
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/raycast

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add raycast -- npx -y raycast-mcp-server
```

### Codex

**Platform CLI**
```bash
codex mcp add raycast -- npx -y raycast-mcp-server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "raycast": {
            "command": "npx",
            "args": [
                "-y",
                "raycast-mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "raycast": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "raycast-mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add raycast npx -y raycast-mcp-server
```

## When to use it
- 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
- 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.

## Similar
- [raycast-extension](https://affpapa.org/en/nevibecode/skills/raycast-extension.md) — skill · 332 installs
- [capture-screen](https://affpapa.org/en/nevibecode/skills/capture-screen.md) — skill · 1100 installs
- [findmy](https://affpapa.org/en/nevibecode/skills/findmy.md) — skill · 400 installs
- [macOS-MCP](https://affpapa.org/en/nevibecode/mcp/macos-mcp.md) — MCP server · ★ 248 repo stars
- [JCAppleScript](https://affpapa.org/en/nevibecode/mcp/jcapplescript.md) — MCP server · ★ 28 repo stars
- [hunch](https://affpapa.org/en/nevibecode/mcp/hunch.md) — MCP server · ★ 26 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
