Needle
Overview
Description from the maker (original English)
Find perfect leads and run outreach campaigns on Linkedin, email, Instagram and more.
PopNx MCP’s three pillars
These three are never merged into one score: opinions, measurements and popularity are different things.
- User voiceiNo reviews yetReviews open together with accounts in a later step
- Our basic checksi3 of 3 passedChecked from public information; code not scanned yet
- UsageiVery new★ –
What you can do with it
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
- Connection: Runs in the cloud
- Transport: Streamable HTTP
- Category: Marketing & social media
Install
Pick the AI app you use, then copy the settings.
Before you install
- Basic checks: 3 of 3 passed
- Runs on the maker’s server: what you ask it goes through their server.
- The registry lists no key to fill in.
You need
- Runs in the cloudNothing to install; it connects over the internet
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
Works in Claude on the web, desktop and mobile:
- Open Settings → Connectors
- Press Add custom connector
- Paste the address below and press Add
- If it asks you to sign in, sign in with the maker
https://needle.app/mcp/v1Run this in your terminal
claude mcp add --transport http needle https://needle.app/mcp/v1Or copy the settings yourself
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"needle": {
"url": "https://needle.app/mcp/v1"
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Or copy the settings yourself
Paste into .vscode/mcp.json in your project
{
"servers": {
"needle": {
"type": "http",
"url": "https://needle.app/mcp/v1"
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
ChatGPT connects only to servers on the internet:
- Open ChatGPT on the web → Settings → Connectors (Apps)
- Press Create or Add (some plans need Developer mode under Advanced first)
- Paste the address below, give it a name and save
- If it asks you to sign in, sign in with the maker
https://needle.app/mcp/v1Menu names can differ slightly by plan and over time.
Your choice stays on this device in a cookie; no account needed.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
What it can do
The server asks you to sign in before it lists its tools.
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026
- ✓ Pass
Maker matches the repo
The registry name was verified against the domain needle.app (the registry checks domain ownership)
- … Not checked yet
Still maintained
We have not read this repo from GitHub yet
- … Not checked yet
Has a licence
We have not read this repo from GitHub yet
- ✓ Pass
Endpoint responds
Responded in 614 ms (HTTP 401)
- ✓ Pass
Sign-in with OAuth
Declares OAuth sign-in, so your AI app can take you to log in
- … Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint
Compared with others in Marketing & social mediai
- More stars than 0% of the other 3593 servers in this category
- Published to the registry more recently than 93% of the other 3593 servers in this category
- Basic checks equal to or better than 100% of the other 3593 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is Needle safe?
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
The registry does not list a required key, though some servers ask you to sign in on first use.
Does it run on my computer or in the cloud?
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
Is it still maintained?
The GitHub repo last changed –, and the latest version (1.0.1) reached the registry 2 days ago.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.
What can I use instead?
In the same category: MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer
Alternatives
Servers in the same category from other makers, sorted by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Google Analytics MCP
GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
README from the maker
Open the README
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Needle MCP
The Needle outbound engine, as tools an agent can call. Build lead lists and run outreach on LinkedIn, Instagram, and email from Claude, ChatGPT, Codex, Cursor, Grok, OpenCode, or any MCP client.
This repository is the setup guide. The server is hosted at:
https://needle.app/mcp/v1
Parameters, limits, and the full tool list are in the Needle MCP docs.
What you can do
- Leads. Build lead lists from LinkedIn and Places.
- Campaigns. Run multi-channel, multi-account outreach on LinkedIn and Instagram.
- Drafts. Draft messages for a person to review and approve before they send.
- LinkedIn. Search people and run outreach from connected accounts.
- Instagram. 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, then attach it to a LinkedIn message or InMail.
Prefer HTTP? Use the API reference. New to Needle? Start with the onboarding skill.
Install the Needle agent skill:
npx skills add needle-ai/needle-mcp
Example prompts
Paste one of these into your agent once Needle is connected.
Finish onboarding
Help me finish my Needle onboarding. Read my onboarding info to see my ideal customer profile, the leads Needle found, and my draft campaign. Then activate my campaign, and after that start looking for more leads.
Leads from a LinkedIn post
Pull the people who commented on and reacted to this LinkedIn post: [paste the post URL]. Add the ones who fit my ideal customer as leads, skip anyone already in my workspace, and draft a short first message for the best fits.
Warm intros
Look through my LinkedIn connections and find who can give me a warm intro to [name or company]. Rank the best paths, say why each person is a good route, and draft a short note I can send them.
Set up
Every app signs you in with OAuth in the browser. An API key in the Authorization header works too. See Authentication.
Listing tools at https://needle.app/mcp/v1/tools does not require sign-in.
Claude
Add Needle to Claude on the web and desktop. Claude opens its add dialog with Needle filled in. Click Continue, then Connect. Sign in to Needle and click Allow.
ChatGPT
Add Needle as a custom MCP app. Developer mode has to be on.
- In ChatGPT, open Settings, then Security and login, and turn on Developer mode.
- Open chatgpt.com/plugins and click +.
- Click Create custom MCP server, then Create MCP App.
- Enter Needle as the name. Under Connection, keep Server URL and paste
https://needle.app/mcp/v1. - Keep Authentication on OAuth, tick I understand and want to continue, and click Create.
ChatGPT asks you to add Needle. Click Sign in with Needle, sign in, and click Allow.
Codex
codex mcp add needle --url https://needle.app/mcp/v1
Then run codex mcp login needle, sign in, and click Allow. codex mcp list shows needle as enabled.
Cursor
Add Needle to Cursor. Cursor opens Needle in the browser. Sign in and click Allow.
Or paste this into .cursor/mcp.json (this project) or ~/.cursor/mcp.json (every project):
{
"mcpServers": { "needle": { "url": "https://needle.app/mcp/v1" } } }
Grok
- Open grok.com/connectors.
- Click New Connector, then Custom.
- Enter Needle as the name and
https://needle.app/mcp/v1as the server URL. - Click Add Connector.
Grok opens Needle in the browser. Sign in and click Allow.
Grok Bot
Grok Bot adds connectors from chat.
- Open Grok Bot on desktop or iOS and start a chat.
- Send this message:
Add a custom MCP server called needle at https://needle.app/mcp/v1. It supports OAuth.
- When Grok Bot asks to confirm, click Add it.
- Click the connect card, sign in to Needle, and click Allow.
Needle's tools are ready from the next message.
OpenCode
Add this to opencode.json:
{
"mcp": { "needle": { "type": "remote", "url": "https://needle.app/mcp/v1", "enabled": true } } }
Run opencode mcp auth needle, sign in, and click Allow.
Another app
Paste https://needle.app/mcp/v1 where the app asks for an MCP server. On first use it opens a Needle sign-in page. Sign in and click Allow.
Authentication
Sign in, click Allow, and the connection is done. Each connection is bound to one user and one workspace. Tokens expire after an hour and refresh on their own. Sessions are listed under Settings → Sessions, where you can disconnect one.
To use an API key, send the same header as the REST API:
Authorization: Bearer sk-ndl-…
Create a key under API keys. Each key is bound to one user and one workspace.
Docs
- Needle MCP — setup and every tool
- Authentication
- API reference
- Onboarding skill
- Agent docs index