{"id":47409707,"url":"https://github.com/ExpertVagabond/raycast-mcp-server","last_synced_at":"2026-04-04T02:01:05.384Z","repository":{"id":315627307,"uuid":"1060283074","full_name":"ExpertVagabond/raycast-mcp-server","owner":"ExpertVagabond","description":"Model Context Protocol server for Raycast — 9 tools for AI-native macOS workflow automation","archived":false,"fork":false,"pushed_at":"2026-03-24T04:21:39.000Z","size":9871,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-25T05:25:31.011Z","etag":null,"topics":["ai","ai-tools","macos","mcp","mcp-server","model-context-protocol","productivity","raycast","tools"],"latest_commit_sha":null,"homepage":"- Creating gist raycast-mcp-server-quickstart.md\n✓ Created public gist raycast-mcp-server-quickstart.md\nhttps://gist.github.com/ExpertVagabond/301ad9528f8a2866c746b7b4005e82a8","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ExpertVagabond.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-19T16:54:07.000Z","updated_at":"2026-03-24T04:21:42.000Z","dependencies_parsed_at":"2025-09-19T18:59:00.265Z","dependency_job_id":null,"html_url":"https://github.com/ExpertVagabond/raycast-mcp-server","commit_stats":null,"previous_names":["expertvagabond/raycast-mcp-server"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ExpertVagabond/raycast-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ExpertVagabond%2Fraycast-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ExpertVagabond%2Fraycast-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ExpertVagabond%2Fraycast-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ExpertVagabond%2Fraycast-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ExpertVagabond","download_url":"https://codeload.github.com/ExpertVagabond/raycast-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ExpertVagabond%2Fraycast-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31384847,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T01:22:39.193Z","status":"online","status_checked_at":"2026-04-04T02:00:07.569Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-tools","macos","mcp","mcp-server","model-context-protocol","productivity","raycast","tools"],"created_at":"2026-03-20T23:00:22.189Z","updated_at":"2026-04-04T02:01:05.287Z","avatar_url":"https://github.com/ExpertVagabond.png","language":"JavaScript","funding_links":[],"categories":["Workflow \u0026 Automation Mcp Servers"],"sub_categories":[],"readme":"# Raycast MCP Server\n\nA comprehensive Model Context Protocol (MCP) server for Raycast workflow automation, providing 9 powerful tools to integrate Raycast with AI assistants like Claude.\n\n## Features\n\n### 🔧 **9 Comprehensive Tools**\n\n1. **raycast_auth** - Manage Raycast and service authentication\n2. **raycast_extensions** - Manage Raycast extensions and store integration  \n3. **raycast_workflows** - Create and manage Raycast workflows and automations\n4. **raycast_search** - Search and launch applications, files, or commands via Raycast\n5. **raycast_clipboard** - Manage clipboard history via Raycast\n6. **raycast_shortcut** - Trigger Raycast shortcuts and hotkeys\n7. **raycast_window** - Control Raycast window behavior\n8. **raycast_system** - Access system functions through Raycast\n9. **Plus additional workflow tools**\n\n### 🚀 **Capabilities**\n- Full OAuth integration support for multiple services\n- Extension management and publishing workflow\n- Custom workflow creation and execution\n- System automation and control\n- Clipboard management\n- Search and navigation\n\n## Installation\n\n### Via Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"raycast\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/raycast-mcp/dist/index.js\"],\n      \"env\": {\n        \"RAYCAST_API_KEY\": \"${RAYCAST_API_KEY}\",\n        \"RAYCAST_TEAM_ID\": \"${RAYCAST_TEAM_ID}\"\n      }\n    }\n  }\n}\n```\n\n### Via NPX (Coming Soon)\n\n```bash\nnpx raycast-mcp-server\n```\n\n### Via Smithery\n\n```bash\nsmithery install raycast-mcp-server\n```\n\n## Development\n\n### Prerequisites\n- Node.js 18+\n- TypeScript\n- Raycast installed on macOS\n\n### Setup\n\n```bash\ngit clone https://github.com/ExpertVagabond/raycast-mcp-server.git\ncd raycast-mcp-server\nnpm install\nnpm run build\n```\n\n### Running Locally\n\n```bash\nnpm start\n```\n\n### Building for Production\n\n```bash\nnpm run build\n```\n\n## Usage Examples\n\n### Authentication Management\n```bash\n# Setup GitHub authentication\n{\"tool\": \"raycast_auth\", \"arguments\": {\"action\": \"setup\", \"service\": \"github\"}}\n\n# Validate credentials  \n{\"tool\": \"raycast_auth\", \"arguments\": {\"action\": \"validate\", \"service\": \"github\"}}\n```\n\n### Extension Management\n```bash\n# Search for extensions\n{\"tool\": \"raycast_extensions\", \"arguments\": {\"action\": \"search\", \"query\": \"github\"}}\n\n# List installed extensions\n{\"tool\": \"raycast_extensions\", \"arguments\": {\"action\": \"list\"}}\n```\n\n### Workflow Automation\n```bash\n# Create a custom workflow\n{\"tool\": \"raycast_workflows\", \"arguments\": {\n  \"action\": \"create\",\n  \"name\": \"morning-routine\",\n  \"steps\": [\n    {\"type\": \"command\", \"action\": \"open-calendar\"},\n    {\"type\": \"api_call\", \"action\": \"fetch-weather\"},\n    {\"type\": \"notification\", \"action\": \"daily-summary\"}\n  ]\n}}\n\n# Execute a workflow\n{\"tool\": \"raycast_workflows\", \"arguments\": {\"action\": \"execute\", \"name\": \"morning-routine\"}}\n```\n\n## Environment Variables\n\n- `RAYCAST_API_KEY` - Raycast API key (if available)\n- `RAYCAST_TEAM_ID` - Raycast team ID (if applicable)\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests if applicable  \n5. Submit a pull request\n\n## License\n\nMIT\n\n## Support\n\nFor issues and feature requests, please use the [GitHub Issues](https://github.com/ExpertVagabond/raycast-mcp-server/issues) page.\n\n---\n\nBuilt with ❤️ for the Raycast and MCP communities.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FExpertVagabond%2Fraycast-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FExpertVagabond%2Fraycast-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FExpertVagabond%2Fraycast-mcp-server/lists"}