Skip to main content
MCP server CX Codex

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 GitHub

What 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.

Project sponsors

Companies that keep this analytics open