Equals MCP

The Equals MCP server gives AI assistants direct access to your Equals workspace. You can search workbooks and ask the Equals agent questions about your data. Please note that MCP/Slack AI calls cost normal Equals AI credits.

Claude

Team, Enterprise

Adding the Equals MCP server to your Claude team will allow anyone on your team to connect Equals to their Claude sessions.

You must be an Owner in your Claude team to add a custom connector.

Visit the the Connectors page, then click the + button and select Add custom connector:

Then enter “Equals” as the Name, and https://go.equals.com/api/mcp as the Remote MCP Server URL, and then click Add.

Users can then enable the Equals connector in their Claude sessions. This will open a browser tab to authenticate in Equals to establish the connection.

Free, Pro

Go to Settings → Developer and click Edit config:

This will open the location of the claude_desktop_config.json file. Open this file with a text editor and add the following:

{
  "mcpServers": {
    "equals": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://go.equals.com/api/mcp"]
    }
  }
}

This should live alongside any existing preferences, like so:

Save this file, then restart Claude Desktop. On first use, a browser window will open to authorize the connection.

Claude Code

Run the following in your terminal:

claude mcp add --transport http equals https://go.equals.com/api/mcp

Then run /mcp inside a Claude Code session to authenticate.

ChatGPT

Web

Visit https://chatgpt.com/plugins and click the plus on the top right.

Then enter “Equals” as the Name, https://go.equals.com/api/mcp as the Connection, check I understand and want to continue, and then click Create.

Finally, click Sign in with Equals to authenticate.

Desktop

Go to Settings → Plugins → MCPs and click Add server.

Enter “Equals” as the Name, select Streamable HTTP as the type, and https://go.equals.com/api/mcp as the URL. Leave the Bearer token env var and all of the headers fields blank. Then click Save.

Finally, click Authenticate next to the newly added server.

Codex

Add the server to ~/.codex/config.toml (or .codex/config.toml in a project for a project-scoped setup):

[mcp_servers.equals]
url = "https://go.equals.com/api/mcp"

Then authenticate from your terminal:

codex mcp login equals

This opens a browser window to authorize the connection. If you use the Codex IDE extension instead, open the gear menu → MCP servers → Add server, choose Streamable HTTP, enter https://go.equals.com/api/mcp, then click Authenticate.

Cursor

Open Cursor Settings → MCP, then add a custom server:

{
  "mcpServers": {
    "equals": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://go.equals.com/api/mcp"]
    }
  }
}

VS Code (GitHub Copilot)

Open the Command Palette (Ctrl/Cmd + Shift + P) and run MCP: Add Server
Select Command (stdio)
Enter:

npx mcp-remote https://go.equals.com/api/mcp

Name it equals
Activate it via MCP: List Servers

Or add directly to your settings.json:

{
  "mcp": {
    "servers": {
      "equals": {
        "command": "npx",
        "args": ["-y", "mcp-remote", "https://go.equals.com/api/mcp"]
      }
    }
  }
}

Windsurf

Open Settings (Ctrl/Cmd + ,)
Scroll to Cascade → MCP Servers
Add a custom server:

{
  "mcpServers": {
    "equals": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://go.equals.com/api/mcp"]
    }
  }
}

Zed

Open your settings (Cmd + ,) and add:

{
  "context_servers": {
    "equals": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://go.equals.com/api/mcp"],
      "env": {}
    }
  }
}

Other Tools

If your tool isn’t listed above, it can still connect — the setup follows one of the same two patterns:

If it supports remote MCP servers, add https://go.equals.com/api/mcp wherever it accepts a server URL, as in the Claude, ChatGPT, and Codex setups above.
If it only supports local MCP servers, configure it to run the command npx -y mcp-remote https://go.equals.com/api/mcp, which bridges to the remote server — the same pattern as the Cursor, Windsurf, and Zed configs above.

Either way, a browser window will open on first use to authorize the connection with your Equals account.

What You Can Do

Once connected, your AI assistant can:

Find Workbooks

Search workbooks in your Equals workspace by name or content, and list your team’s trusted workbooks — curated, vetted analyses that are surfaced first as the most reliable sources to reference.

Query Datasources

List connected datasources, explore their schema, and directly run SQL queries.

Ask Equals

Ask questions about your data in natural language. The Equals agent can query all your connected datasources and read any workbook you have access to, and runs its own analysis to find answers. You can ask follow-up questions in the same conversation, and answers can include a full workbook you can open in Equals. Ask Equals consumes Equals AI credits.

Troubleshooting

Authentication Errors

Make sure you have an active Equals account and that your workspace has MCP enabled. Try disconnecting and reconnecting to go through the authorization flow again.

`npx mcp-remote` Not Found

Make sure Node.js is installed:

node --version

If you don’t have it, download it from here.

Windows

If you are on Windows, you may need to replace "command": "npx", with "command": "C:\\Program Files\\nodejs\\npx.cmd",.

Tool Calls Time Out

The Equals agent can take 1–5 minutes to answer complex questions. Your AI tool should poll for results automatically; if it gives up early, try asking it to wait and check again.

Getting Started

Connect and transform data

Explore data

Analyze data

Report on data

Claude

Team, Enterprise

Free, Pro

Claude Code

ChatGPT

Web

Desktop

Codex

Cursor

VS Code (GitHub Copilot)

Windsurf

Zed

Other Tools

What You Can Do

Find Workbooks

Query Datasources

Ask Equals

Troubleshooting

Authentication Errors

`npx mcp-remote` Not Found

Windows

Tool Calls Time Out

​Claude

​Team, Enterprise

​Free, Pro

​Claude Code

​ChatGPT

​Web

​Desktop

​Codex

​Cursor

​VS Code (GitHub Copilot)

​Windsurf

​Zed

​Other Tools

​What You Can Do

​Find Workbooks

​Query Datasources

​Ask Equals

​Troubleshooting

​Authentication Errors

​npx mcp-remote Not Found

​Windows

​Tool Calls Time Out

Claude

Team, Enterprise

Free, Pro

Claude Code

ChatGPT

Web

Desktop

Codex

Cursor

VS Code (GitHub Copilot)

Windsurf

Zed

Other Tools

What You Can Do

Find Workbooks

Query Datasources

Ask Equals

Troubleshooting

Authentication Errors

`npx mcp-remote` Not Found

Windows

Tool Calls Time Out