English Français العربية

io.github.ExpertVagabond/raycast

Official registry Other

Raycast workflow automation MCP server with 9 tools

Source code Documentation

What can you do with io.github.ExpertVagabond/raycast?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package raycast-mcp-server
Claude Code 
claude mcp add raycast -- npx -y raycast-mcp-server@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "raycast": {
            "command": "npx",
            "args": [
                "-y",
                "raycast-mcp-server@1.0.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Raycast MCP Server
  2. Features
  3. Installation
  4. Development
  5. Usage Examples
  6. Environment Variables
  7. Contributing
  8. License
  9. Support

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.

Frequently asked questions

What is io.github.ExpertVagabond/raycast?

Raycast workflow automation MCP server with 9 tools

How do I install io.github.ExpertVagabond/raycast?

It runs on your machine. In Claude Code: claude mcp add raycast -- npx -y raycast-mcp-server@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ExpertVagabond/raycast need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.ExpertVagabond/raycast open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.ExpertVagabond/raycast?

It is published by ExpertVagabond. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.