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
  • Connections finished so the server header shows Ready
  • Credentials connected for the providers on that MCP server

Time to complete: 2-3 minutes

Quick start (dashboard)​

  1. Open your MCP server in the MCPBundles dashboard.
  2. When the server is enabled and exposes tools, copy the MCP server URL from the orange-bordered setup card (URL row at the top of the card).
  3. Expand Setup instructions on that card, open the Raycast tab, and use the Name, Transport, and URL fields shown there when you add the server in Raycast.

Raycast is not in the one-click install menu on the setup card (no raycast:// install link). Configure the server inside Raycast manually.

mcpbundles init writes the MCPBundles CLI skill for terminal agents only — it does not register MCP servers in Raycast.

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. Ensure the server is enabled, Connections show Ready, and the setup card is visible (it appears when the server has callable tools)
  4. Copy the MCP server URL from the setup card

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 (match the Raycast tab in Setup instructions):

    • Name: Your MCP server display name (e.g., "Marketing")
    • Transport: 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 nameSame as Setup instructions → Raycast
TransportHTTPRequired for MCPBundles
URLhttps://mcp.mcpbundles.com/...From setup card

Next Steps​

Need Help?​