Raycast

io.github.ExpertVagabondPublished by GitHub account ExpertVagabondv1.0.1Updated Oct 24, 2026

Raycast workflow automation MCP server with 9 tools

VerifiedSTDIODesktop onlyProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

Lets an assistant drive Raycast on macOS: manage extensions and workflows, search and launch apps, handle clipboard history, and trigger shortcuts.

What you can do
A local MCP server exposing nine Raycast tools. It manages Raycast and service authentication, installs and searches extensions, creates and executes custom workflows, searches and launches applications, files or commands, manages clipboard history, triggers shortcuts and hotkeys, controls Raycast window behavior, and accesses system functions.
When to use it
Useful on macOS for automating Raycast itself: building or running workflows, managing extensions, launching apps and commands, or wiring Raycast actions into an assistant-driven routine.
Requirements
Runs locally over stdio as an npm package (raycast-mcp-server) with Node.js 18+ and TypeScript; Raycast must be installed on macOS. The README's config example passes RAYCAST_API_KEY and RAYCAST_TEAM_ID as environment variables, though the manifest declares no authentication or environment variables.
Before you install
The README's example config supplies RAYCAST_API_KEY and RAYCAST_TEAM_ID, and the auth tool manages credentials for other services such as GitHub; treat these as secrets. Workflow, extension, clipboard, shortcut and system tools can change local state or launch and execute things, so review actions before running them.

Installation

In SourceWeft

  1. Open Raycast in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Raycast MCP Server

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

Features

🔧 9 Comprehensive Tools

  1. raycast_auth - Manage Raycast and service authentication
  2. raycast_extensions - Manage Raycast extensions and store integration
  3. raycast_workflows - Create and manage Raycast workflows and automations
  4. raycast_search - Search and launch applications, files, or commands via Raycast
  5. raycast_clipboard - Manage clipboard history via Raycast
  6. raycast_shortcut - Trigger Raycast shortcuts and hotkeys
  7. raycast_window - Control Raycast window behavior
  8. raycast_system - Access system functions through Raycast
  9. Plus additional workflow tools

🚀 Capabilities

  • Full OAuth integration support for multiple services
  • Extension management and publishing workflow
  • Custom workflow creation and execution
  • System automation and control
  • Clipboard management
  • Search and navigation

Installation

Via Claude Desktop

Add to your claude_desktop_config.json:

json
{  "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}"      }    }  }}

Via NPX (Coming Soon)

bash
npx raycast-mcp-server

Via Smithery

bash
smithery install raycast-mcp-server

Development

Prerequisites

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

Setup

bash
git clone https://github.com/ExpertVagabond/raycast-mcp-server.gitcd raycast-mcp-servernpm installnpm run build

Running Locally

bash
npm start

Building for Production

bash
npm run build

Usage Examples

Authentication Management

bash
# Setup GitHub authentication{"tool": "raycast_auth", "arguments": {"action": "setup", "service": "github"}}
# Validate credentials  {"tool": "raycast_auth", "arguments": {"action": "validate", "service": "github"}}

Extension Management

bash
# Search for extensions{"tool": "raycast_extensions", "arguments": {"action": "search", "query": "github"}}
# List installed extensions{"tool": "raycast_extensions", "arguments": {"action": "list"}}

Workflow Automation

bash
# Create a custom workflow{"tool": "raycast_workflows", "arguments": {  "action": "create",  "name": "morning-routine",  "steps": [    {"type": "command", "action": "open-calendar"},    {"type": "api_call", "action": "fetch-weather"},    {"type": "notification", "action": "daily-summary"}  ]}}
# Execute a workflow{"tool": "raycast_workflows", "arguments": {"action": "execute", "name": "morning-routine"}}

Environment Variables

  • RAYCAST_API_KEY - Raycast API key (if available)
  • RAYCAST_TEAM_ID - Raycast team ID (if applicable)

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests if applicable
  5. Submit a pull request

License

MIT

Support

For issues and feature requests, please use the GitHub Issues page.

Built with ❤️ for the Raycast and MCP communities.

Source: README.md at commit 90a49d4

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts