# Connect iClosed to Cursor

**Before you connect:** MCP must be turned on for your workspace (**Settings → Developer → MCP**, by an account owner or super admin). You don't need an API key. [More about requirements](/docs/mcp/introduction#before-you-connect).

## One-click install

[**Add to Cursor**](cursor://anysphere.cursor-deeplink/mcp/install?name=iclosed&config=eyJ1cmwiOiJodHRwczovL21jcC5pY2xvc2VkLmlvL21jcCJ9)

Cursor opens and asks you to confirm the new server. Then go to [Sign in](#sign-in).

## Manual setup

### Option A: for all your projects

Edit (or create) the user config file:

| OS | Path |
|  --- | --- |
| **macOS / Linux** | `~/.cursor/mcp.json` |
| **Windows** | `%USERPROFILE%\.cursor\mcp.json` |


Add the iClosed server:

```json
{
  "mcpServers": {
    "iclosed": {
      "url": "https://mcp.iclosed.io/mcp"
    }
  }
}
```

If the file already lists other servers, add `iclosed` inside the existing `mcpServers` object.

### Option B: for one project

Create `.cursor/mcp.json` at the root of the repository with the same JSON. The file holds only the URL, so it is safe to commit.

## Sign in

1. Open the **Customize** page from Cursor's sidebar, where your MCP servers are listed.
2. Find **iclosed** and turn it on.
3. Your browser opens the iClosed consent screen. Sign in and click **Allow access**.


## Check that it works

In Agent chat, ask: **"Show me my contacts in iClosed."** You should see an iClosed tool call and an answer from your workspace.

If something goes wrong, see [Troubleshooting](/docs/mcp/troubleshooting).