MCP
Needle MCP
Needle MCP server (v1).
The same outbound engine as the REST API, as tools your agent can call. Works with Claude Code, Cowork, Codex, Cursor, Hermes, or any MCP client.
Prefer HTTP? See the API Reference. New here? Start at the onboarding skill.
Set up Needle MCP
Every app signs you in with OAuth in your browser; no API key needed. An API key in the Authorization header works too, see Authentication.
Add Needle to Claude on the web and desktop with one click. No API key needed.
Claude opens its add dialog with Needle filled in. Click Continue, then Connect; sign in to Needle and click Allow.
Using another app? Paste this URL where the app asks for an MCP server. On first use it opens a Needle sign-in page; sign in and click Allow.
Prompts to try
Paste one into your agent after Needle is connected.
Finish onboarding
People from a LinkedIn post
Warm intros
Features
Leads
Build lead lists from LinkedIn and the Places API.
Campaigns
Run multi-channel, multi-account outreach on LinkedIn and Instagram.
Drafts
Draft messages for a person to review and approve before they send.
Search people and run outreach from connected accounts.
Reach people on Instagram from connected accounts.
Events
Search activity across campaigns, leads, and connected accounts.
Places
Find companies and locations to source lists.
Connected Accounts
Connect LinkedIn and Instagram accounts to send from.
Suppressions
Keep people and companies you should not contact off the list.
Webhooks
Receive every outbound event at your own URL as it happens.
Compose
Preview a message before you send it.
Files
Store a private file (upload bytes, or copy a public URL), list files in the workspace, then attach one to a LinkedIn message or InMail.
Authentication
Your MCP client signs you in. Claude.ai and Claude Desktop, Claude Code, Codex and ChatGPT developer mode open Needle in your browser on first use; sign in and click Allow. Tokens expire after an hour and refresh on their own. The session shows under Settings → Sessions, where you can disconnect it. For Claude.ai and Claude Desktop, add Needle as a custom connector in one click. Each connection is bound to one user and one workspace. Listing tools at /mcp/v1/tools requires no sign-in.
Me
Connected accounts
- TOOLList connected accounts
- TOOLSearch connected accounts
- TOOLGet a connected account
- TOOLUpdate a connected account
- TOOLDelete a connected account
- TOOLList connected account limits
- TOOLOverride a connected account limit
- TOOLReset a connected account limit
- TOOLList connected account events
- TOOLList connected account tasks
Leads
Campaigns
- TOOLList campaigns
- TOOLSearch campaigns
- TOOLSearch enrollments
- TOOLCreate a campaign
- TOOLGet a campaign
- TOOLUpdate a campaign
- TOOLArchive a campaign
- TOOLGet campaign stats
- TOOLList campaign events
- TOOLList campaign tasks
- TOOLList campaign leads
- TOOLEnroll leads
- TOOLStop a lead in a campaign
- TOOLStop leads in a campaign in bulk
Drafts
Events
- TOOLGet a LinkedIn profile
- TOOLSearch LinkedIn people
- TOOLSearch LinkedIn people (Classic)
- TOOLSearch LinkedIn people (Sales Navigator)
- TOOLSend a LinkedIn message
- TOOLSend a Sales Navigator InMail
- TOOLGet remaining InMail credits
- TOOLList conversations
- TOOLList messages in a conversation
- TOOLList pending invitations
- TOOLSend a connection invitation
- TOOLWithdraw an invitation
- TOOLList invitations sent to you
- TOOLAccept or decline a received invitation
- TOOLList followers
- TOOLList accounts this account follows
- TOOLList first-degree connections
- TOOLGet a LinkedIn company
- TOOLList jobs posted by a company
- TOOLList posts from a company page
- TOOLSearch LinkedIn jobs
- TOOLGet a LinkedIn job
- TOOLSearch LinkedIn companies (Classic)
- TOOLSearch LinkedIn posts
- TOOLList posts by a person or company
- TOOLGet a LinkedIn post
- TOOLList comments on a post
- TOOLList reactions on a post
- TOOLComment on a post
- TOOLReact to a post
- TOOLList LinkedIn search parameters
- TOOLGet an Instagram profile
- TOOLGet the connected account profile
- TOOLSend an Instagram message
- TOOLReact to an Instagram message
- TOOLList Instagram conversations
- TOOLList messages in a conversation
- TOOLList the participants of a conversation
- TOOLList the posts of an account
- TOOLGet an Instagram post
- TOOLPublish an Instagram post
- TOOLList the comments on a post
- TOOLComment on a post
- TOOLList the likes on a post
- TOOLLike a post
- TOOLList followers
- TOOLList followed accounts
- TOOLFollow an Instagram user
- TOOLUnfollow an Instagram user