io.github.ExpertVagabond/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.git
cd raycast-mcp-server
npm install
npm 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.