Docs

Claude Desktop

Add Grovs to Claude Desktop so you can manage links and pull analytics from a chat.

Add the Grovs MCP server to Claude Desktop and Claude can manage your deep links, pull analytics, and change project settings from inside any conversation.

Prerequisites

  • Claude Desktop installed (download here)
  • A Grovs account with at least one project

Claude Desktop does not support remote MCP servers directly in claude_desktop_config.json. Use the Connectors UI instead — it's the recommended path. If you're on an older version of Claude Desktop or prefer a config file, see the fallback below.

Setup (Connectors UI)

1

Open the Connectors settings

In Claude Desktop, open Settings → Connectors → Add custom connector.

2

Enter the Grovs server URL

Fill in the form:

  • Name: Grovs
  • Remote MCP server URL: https://mcp.grovs.io/mcp

Click Add.

3

Connect and authorize

After adding the connector, Grovs will appear in your Connectors list with a Not connected status. Click the Grovs entry, then click Connect.

A browser window opens to start the OAuth flow:

  1. Log in to your Grovs account if prompted
  2. Review the permissions and click Authorize
  3. The browser confirms the connection. You can close it and return to Claude Desktop.

The connector status should now show as Connected.

4

Start using Grovs

You're connected. Try asking Claude:

  • "Show me my Grovs projects"
  • "Create a deep link for our summer campaign"
  • "What are the top performing links this week?"

If you are self-hosting Grovs, replace mcp.grovs.io with your own MCP subdomain.

Fallback: config file with mcp-remote

If the Connectors UI isn't available in your Claude Desktop build, you can use mcp-remote as a local stdio bridge to the remote server.

Open Settings → Developer → Edit Config and add:

JSON
{
  "mcpServers": {
    "grovs": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.grovs.io/mcp"]
    }
  }
}

Save and restart Claude Desktop. The first run downloads mcp-remote via npx and opens a browser for OAuth. Requires Node.js installed locally.

Managing the Connection

Open Settings → Connectors, click Grovs, and choose Disconnect.

You can also revoke access from the Grovs dashboard — see Revoking access.

Troubleshooting

Claude doesn't show Grovs tools

  • Make sure the connector is enabled in Settings → Connectors
  • Restart Claude Desktop after adding the connector
  • Verify the URL is exactly https://mcp.grovs.io/mcp

Authorization window doesn't open

  • Check your browser's popup blocker settings
  • Try the mcp-remote fallback if the Connectors UI is misbehaving

"Token expired" errors

Tokens refresh automatically. If you see persistent auth errors, revoke access from Account Settings → Connected Apps in the Grovs dashboard and reconnect from Claude Desktop.