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

# MCP

> Use Needle from Claude, ChatGPT, Cursor, or any MCP client.

Needle exposes its tools over the [Model Context Protocol](https://modelcontextprotocol.io), so you can work your pipeline from any MCP client. The server URL is:

```text theme={null}
https://mcp.needle.so/mcp
```

You'll find these same instructions in the app under **Settings → MCP Server**.

## Connect your client

<Tabs>
  <Tab title="Claude.ai / ChatGPT">
    Add Needle as a custom connector. You'll sign in with your Needle account when connecting.

    1. Go to [claude.ai/customize/connectors](https://claude.ai/customize/connectors)
    2. Click the **+** button (top right), then **Add custom connector**
    3. Paste the server URL and save:

    ```text theme={null}
    https://mcp.needle.so/mcp
    ```

    4. Click **Configure** to sign in with Needle

    The steps in ChatGPT are equivalent: add a custom MCP connector with the same URL.
  </Tab>

  <Tab title="Claude Code">
    Run this in your terminal. You'll be prompted to sign in with Needle on first use.

    ```bash theme={null}
    claude mcp add --transport http needle https://mcp.needle.so/mcp
    ```
  </Tab>

  <Tab title="Cursor / Windsurf">
    Add this to your Cursor or Windsurf MCP settings file. You'll be prompted to sign in with Needle on first use.

    ```json theme={null}
    {
      "mcpServers": {
        "needle": {
          "url": "https://mcp.needle.so/mcp"
        }
      }
    }
    ```
  </Tab>
</Tabs>

Authentication is OAuth — you sign in with your Needle account and the connection is scoped to your organization. No API keys to manage.

## What your assistant can do

Search candidates and jobs, read pipelines and screening results, move candidates through stages, add notes, draft and send emails, check interview schedules, and manage outreach — enroll candidates, pause a run, edit a queued message.

## Permissions and approvals

MCP access follows the same rules as the app: everything is scoped to your organization, actions are logged on candidate timelines, and outbound messages are created as drafts for you to approve before they send.