Skip to main content

Raycast Integration

Connect your MCP bundles to Raycast to access tools from your favorite productivity launcher.

Requirements​

  • Raycast with MCP support (update if needed)
  • A bundle enabled in your MCPBundles dashboard
  • Credentials connected for providers in your bundle

Time to complete: 2-3 minutes

Step-by-Step Setup​

1. Get Your Bundle URL​

  1. Log in to MCPBundles Dashboard
  2. Click on the bundle you want to use
  3. Copy the MCP Server URL

2. Open Raycast MCP Settings​

  1. Open Raycast (Cmd + Space or your trigger)
  2. Type "Extensions" and select Extensions
  3. Find MCP extension (or search for it)
  4. Click on MCP extension settings

3. Add MCP Server​

  1. In MCP settings, click Add Server or + New

  2. Fill out the form:

    • Name: Your bundle name (e.g., "Marketing")
    • Transport: Select HTTP
    • URL: Your bundle URL from step 1

  3. Click Add or Save

4. Test the Connection​

  1. Open Raycast
  2. Type "MCP" to see MCP-related commands
  3. Or invoke the AI assistant and ask: "What tools do you have?"

Expected: Raycast should list tools from your bundle.

Using Tools in Raycast​

Once connected, you can invoke tools through Raycast's interface.

Example Use Cases​

Quick data lookup:

  • Trigger: "List my Smartlead campaigns"
  • Raycast calls the tool and displays results

Automation:

  • Trigger: "Add contact to HubSpot"
  • Fill in parameters via Raycast UI
  • Tool executes

Workflows:

  • Chain multiple tool calls in Raycast scripts

Troubleshooting​

"Server not responding"​

Fix:

  • Verify URL is correct (including https://)
  • Check bundle is enabled in dashboard
  • Try removing and re-adding the server
  • Restart Raycast

"Authentication required"​

Fix:

  1. Go to Dashboard → Providers
  2. Connect credentials for needed providers
  3. Try the tool again in Raycast

See Provider Credentials Guide.

Configuration Details​

FieldValueNotes
NameYour bundle nameDisplayed in Raycast
TransportHTTPRequired for MCPBundles
URLhttps://mcp.mcpbundles.com/...From dashboard

Next Steps​

Need Help?​