Skip to main content
You’ll need a Gumloop API key. Generate one in the Gumloop API key row of your Profile settings. To get there, open Settings at the bottom of the left sidebar, then Profile. See Find your Gumloop API key. The server handles OAuth automatically: the first time you connect, it prompts you to sign in and authorize access.

​
Claude

Add Gumloop to Claude as a custom connector, then sign in to Gumloop once to authorize it. These steps work in Claude on the web and in Claude Desktop.
1

Open Connectors in Claude

In Claude, open Settings, then choose Connectors under Customize in the left sidebar.
2

Choose Add custom connector

Click Add in the top-right corner of the Connectors page, then choose Add custom connector.
Claude Connectors settings page with the Add menu open, showing Add custom connector
3

Enter the name and server URL

In the Add custom connector dialog, enter Gumloop as the name (it’s shown in the connectors list). In the URL field, paste the Gumloop MCP server URL, then click Continue:
Add custom connector dialog with the name Gumloop and the URL https://mcp.gumloop.com/gumloop/mcp, and the Continue button
4

Connect and sign in to Gumloop

If Claude doesn’t open the sign-in page right away, click Connect next to Gumloop in the connectors list. A Gumloop page opens in your browser. Sign in to Gumloop if you aren’t already.
5

Allow access on the Authorize Claude screen

On the Authorize Claude screen, keep Team set to Personal. Your personal key also lets Claude run and edit agents in the teams you belong to. Check that Gumloop API Key shows Connected, then click Allow.
Gumloop Authorize Claude screen with Team set to Personal, Connector Gumloop API Key marked Connected, and Deny and Allow buttons
6

Confirm the connection

Back in Claude, the Gumloop row in Settings > Connectors shows a checkmark instead of a Connect button. Start a new chat and ask Claude something like “List my Gumloop agents” to check that the tools work.
Once connected, you can ask Claude to create, update, and run your Gumloop agents. See example prompts.

​
Claude Code

Add the server from your terminal:
Then start Claude Code, run /mcp, and select gumloop. A Gumloop page opens in your browser. Sign in, keep Team set to Personal on the Gumloop authorize screen, and click Allow.

​
Cursor

  1. Open Cursor Settings (Cmd/Ctrl + Shift + J)
  2. Go to MCP and click Add new MCP server
  3. Select Type: SSE and enter the server URL:

​
VS Code

Add this configuration to your .vscode/mcp.json:

​
Windsurf

  1. Open Windsurf settings (Cmd/Ctrl + ,)
  2. Scroll to Cascade > MCP servers
  3. Select Add Server > Add custom server
  4. Add this configuration:

​
Gumloop CLI

Explore and call tools from your terminal:
See the full reference in the CLI MCP docs. For connection issues, see Gumloop MCP troubleshooting.