Raycast MCP Server

Raycast workflow automation MCP server with 9 tools

Local serverstdioTypeScript

What is the Raycast MCP server?

Raycast MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Raycast workflow automation MCP server with 9 tools.

What you get

A comprehensive Model Context Protocol (MCP) server for Raycast workflow automation, providing 9 powerful tools to integrate Raycast with AI assistants like Claude.

What the assistant can call

Once Raycast is connected, these are the calls the assistant has available:

  • Prerequisites — The Prerequisites tool exposed by this server
  • Setup — The Setup tool exposed by this server

Setting it up

raycast-mcp-server on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Configuration and credentials

You will need 2 environment variables: RAYCAST_API_KEY, RAYCAST_TEAM_ID. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Node.js 18+ - TypeScript - Raycast installed on macOS

Choosing this one

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Raycast's toolset — Prerequisites, Setup — is a fair guide to whether it matches your workflow. It is maintained by ExpertVagabond; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the raycast mcp server does with a few real requests.

Available tools

ToolWhat it does
PrerequisitesThe Prerequisites tool exposed by this server.
SetupThe Setup tool exposed by this server.

How to install the Raycast MCP server

{
  "mcpServers": {
    "raycast": {
      "command": "node",
      "args": ["/path/to/raycast-mcp/dist/index.js"],
      "env": {
        "RAYCAST_API_KEY": "${RAYCAST_API_KEY}",
        "RAYCAST_TEAM_ID": "${RAYCAST_TEAM_ID}"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Node.js 18+ - TypeScript - Raycast installed on macOS
VariableDescriptionRequired
RAYCAST_API_KEYCredential the server authenticates with.Yes
RAYCAST_TEAM_IDConfiguration value read at startup.Optional

Example prompts to try

  • Use Raycast to Prerequisites.
  • Use Raycast to Setup.

Frequently asked questions

It connects Raycast to MCP-compatible AI assistants such as Claude and Cursor, exposing 2 tools (Prerequisites, Setup) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Raycast directly.