Needle MCP
Needle MCP puts outbound sales into agent tools: lead lists, LinkedIn, Instagram and email outreach, and drafts for review.
- 104 ★ on the repository
- Last commit
Broad access
Why this level
- Messages go out from your LinkedIn and Instagram accounts.
- The service gets access to connected accounts and contact lists.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/needle-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Messages go out from your LinkedIn and Instagram accounts.
- The service gets access to connected accounts and contact lists.
This is third-party code. Review the repository files before installing.
What it does
Needle MCP connects an assistant to the Needle outbound sales engine. The assistant builds lead lists from LinkedIn and maps, runs multi-account campaigns on LinkedIn and Instagram, searches people, drafts and previews messages, keeps a suppression list and delivers events to your webhook. Files go to private storage and attach to a LinkedIn message. The server is hosted at `https://needle.app/mcp/v1` with browser OAuth sign-in or an API key in the `Authorization` header. The repository is a connection guide: instructions for Claude, ChatGPT, Codex, Cursor, Grok and OpenCode plus a skill installed with `npx skills add needle-ai/needle-mcp`.
Who it is for. Sales teams and founders running outbound prospecting who want an assistant to prepare lists and drafts.
Good fit when
- People who commented on a LinkedIn post are collected as leads against the ideal customer profile.
- You find which contacts can give a warm intro to a target company.
- The assistant drafts a first message and a person reads and approves it.
- Customers and do-not-contact people are excluded from a campaign list.
Not a fit when
- You want mass messaging that ignores platform rules: messages go from your LinkedIn and Instagram accounts and follow their terms.
- You want a self-hosted server: the Needle code is not in the repository.
- Contacts must not go to a third-party service.
Example request
Collect leads from the commenters of this LinkedIn post, skip those already in the workspace and prepare short drafts without sending.MCP
- Transport
- http
- Authentication
- OAuth
Limitations
A Needle account and connected LinkedIn or Instagram accounts are required. Messages go out in your name, and automated outreach can break platform rules and lead to account restrictions: start small and review drafts. Parameters, limits and the full tool list are in the docs at `needle.app/docs/mcp/introduction`. The repository has no license file, so the Needle service terms govern use.
How to disable. Disconnect the Needle connector in client settings, revoke the API key in the Needle account and detach LinkedIn and Instagram in connected accounts.
FAQ
What is the server address?
`https://needle.app/mcp/v1`. The tool list is visible without sign-in at `https://needle.app/mcp/v1/tools`.
How do I sign in?
Through browser OAuth: click Allow in the Needle window. An API key in the `Authorization` header also works for HTTP calls.
How do I add it to Codex?
With `codex mcp add needle --url https://needle.app/mcp/v1`, then sign in through OAuth.
Do messages go out without review?
The tools can prepare drafts that a person reads and approves before sending. Set the approval mode in your prompt and campaign settings.
Can I see the tool list without signing in?
Yes. `https://needle.app/mcp/v1/tools` lists the tools without authorization. Calls need OAuth sign-in or an API key in the `Authorization` header.
Discussion
No questions or reviews yet.
Related
MCP serversA local MCP server gives an assistant 379 tools for the eBay Sell APIs: listings, orders, payouts, ads and seller analytics.
A remote MCP server with B2B data: companies, contacts and work addresses inside the chat, browser sign-in, no API keys
Open-source CRM for small teams with MCP: contacts, deals and tasks open to Claude and other agents, with reply drafts left to you
Two LinkedIn skills via Linked API: people and company search, messages, posts and a lead pipeline with connection invites.
Hosted MCP server for Amazon Ads and Seller Central: the agent reviews ACoS, search terms and stock, edits on confirmation
Megaplan MCP server
megaplan-mcp
An MCP server for the Megaplan v3 API: tasks, deals, projects and employees through an agent, plus ready-made skills for daily tasks and a deal wizard
README in short
A guide to connecting Needle to assistants: server address, sign-in methods and example prompts. The engine is hosted by Needle, and the repository holds a Cursor plugin manifest, `mcp.json` and a skill.