Skip to main content

Raycast Integration

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

Requirements​

  • Raycast with MCP support (update if needed)
  • An MCP server enabled in your MCPBundles dashboard
  • Credentials connected for the providers on that MCP server

Time to complete: 2-3 minutes

The fastest way to connect is via the MCPBundles CLI:

pip install mcpbundles
mcpbundles init

This automatically discovers your MCP servers and handles authentication. You can also use mcpbundles serve to run a local MCP proxy that Raycast can connect to.

Option B: Manual Config Setup​

1. Get your MCP server URL​

  1. Log in to MCPBundles Dashboard
  2. Open the MCP server you want to connect
  3. Scroll to the "Quick Setup" section (only visible when the MCP server is operational)
  4. 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. Connect MCP server​

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

  2. Fill out the form:

    • Name: Your MCP server display name (e.g., "Marketing")
    • Transport: Select HTTP
    • URL: Your MCPBundles MCP server 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 MCP server.

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://)
  • Confirm the MCP server is enabled in dashboard
  • Try removing and re-adding the server
  • Restart Raycast

"Authentication required"​

Fix:

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

See Provider Credentials Guide.

Configuration Details​

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

Next Steps​

Need Help?​