Needle · needle-ai — Claude Code MCP server: what it does, how to set up
Connects your assistant to the Needle retrieval engine to search and query PDF, DOCX, and XLSX files.
no license updated 2026-10-29
Open on GitHubWhat Needle does
This MCP bridge links coding assistants to the Needle document platform. It allows the model to organize collections, register documents from files or web links, and pull relevant snippets directly into your prompt.
The authors recommend their hosted endpoint at https://mcp.needle.app/mcp, removing any requirement to manage local runtime files. If you prefer running locally, you can launch the Python package with uv or package it as a Docker container.
Every query requires a valid NEEDLE_API_KEY from your account dashboard. The connector fails immediately without this authorization credential.
What it helps with
- extract targeted answers from PDF, spreadsheet, and text files
- build structured document collections for agent memory
- index web URLs into an active knowledge base
- feed retrieved context directly into coding assistant prompts
Example prompts for the agent
- Create a new collection called Architecture Notes
- Index the documentation page at https://needle.app
- Search the collection for details on authentication flow
How to install Needle
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Needle
How do you connect Needle via MCP?
Configure your MCP client using npx mcp-remote https://mcp.needle.app/mcp --header "Authorization:Bearer ${NEEDLE_API_KEY}" and supply your NEEDLE_API_KEY inside the environment block.
What does the Needle server do?
It gives AI assistants direct access to Needle collections so they can index files and run semantic retrieval during chat.
Which server endpoint should be configured?
Pick the Streamable HTTP URL at https://mcp.needle.app/mcp because newer client standards discourage using the older SSE route.
Similar MCP servers
All MCP servers for AI and ML →Needle by other authors comes first.