MCP - Needle

Needle exposes its tools over the Model Context Protocol, so you can work your pipeline from any MCP client. The server URL is:

https://mcp.needle.so/mcp

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

Connect your client

Claude.ai / ChatGPT
Claude Code
Cursor / Windsurf

Add Needle as a custom connector. You’ll sign in with your Needle account when connecting.

Go to claude.ai/customize/connectors
Click the + button (top right), then Add custom connector
Paste the server URL and save:

https://mcp.needle.so/mcp

Click Configure to sign in with Needle

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

Run this in your terminal. You’ll be prompted to sign in with Needle on first use.

claude mcp add --transport http needle https://mcp.needle.so/mcp

Add this to your Cursor or Windsurf MCP settings file. You’ll be prompted to sign in with Needle on first use.

{
  "mcpServers": {
    "needle": {
      "url": "https://mcp.needle.so/mcp"
    }
  }
}

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.

​Connect your client

​What your assistant can do

​Permissions and approvals

Connect your client

What your assistant can do

Permissions and approvals