Raycast

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:

{  "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)

npx raycast-mcp-server

Via Smithery

smithery install raycast-mcp-server

Development

Prerequisites

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

Setup

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

Running Locally

npm start

Building for Production

npm run build

Usage Examples

Authentication Management

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

Extension Management

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

Workflow Automation

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