> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.neetocal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect

> Point your AI assistant at the NeetoCal MCP server.

NeetoCal runs a hosted MCP server — there's nothing to install or run locally. Add it to your AI assistant's MCP configuration with your API key, restart the assistant, and the `neetocal` tools become available.

## Server details

|                    |                                               |
| ------------------ | --------------------------------------------- |
| **Endpoint**       | `https://connect.neetocal.com/mcp/messages`   |
| **Transport**      | HTTP                                          |
| **Authentication** | `Authorization: Bearer <your-api-key>` header |

Paste your [NeetoCal API key](/mcp/authentication) in place of `YOUR_API_KEY` in the config for your assistant below.

## Set up your assistant

<Tabs>
  <Tab title="Claude Code">
    Add the server to `~/.claude.json`:

    ```json theme={"system"}
    {
      "mcpServers": {
        "neetocal": {
          "type": "http",
          "url": "https://connect.neetocal.com/mcp/messages",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    Restart Claude Code after saving.
  </Tab>

  <Tab title="Cursor">
    Create or edit `~/.cursor/mcp.json`:

    ```json theme={"system"}
    {
      "mcpServers": {
        "neetocal": {
          "type": "http",
          "url": "https://connect.neetocal.com/mcp/messages",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    Restart Cursor or reload the window.
  </Tab>

  <Tab title="VS Code">
    Create `.vscode/mcp.json` in your workspace:

    ```json theme={"system"}
    {
      "servers": {
        "neetocal": {
          "type": "http",
          "url": "https://connect.neetocal.com/mcp/messages",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    Requires VS Code 1.99 or later, and the server is used from GitHub Copilot chat's **Agent** mode. VS Code nests the server under `servers` (not `mcpServers`).
  </Tab>

  <Tab title="Windsurf">
    Edit `~/.codeium/windsurf/mcp_config.json`:

    ```json theme={"system"}
    {
      "mcpServers": {
        "neetocal": {
          "serverUrl": "https://connect.neetocal.com/mcp/messages",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    Windsurf uses `serverUrl` (not `url`). Enable the server under **Settings → Cascade → MCP Servers**. Windsurf allows up to 100 MCP tools across all connected servers.
  </Tab>

  <Tab title="Antigravity">
    In Antigravity, open **Settings → Customizations → Open MCP Config**, then add the server to `mcp_config.json`:

    ```json theme={"system"}
    {
      "mcpServers": {
        "neetocal": {
          "serverUrl": "https://connect.neetocal.com/mcp/messages",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```

    Like Windsurf, Antigravity uses `serverUrl` (not `url`). Reload Antigravity after saving.
  </Tab>
</Tabs>

## Verify the connection

Once your assistant reloads, confirm the `neetocal` tools are listed, then try a prompt like *"List my upcoming NeetoCal bookings."* See [Examples](/mcp/examples) for more.
