# Needle

Connects your assistant to the Needle retrieval engine to search and query PDF, DOCX, and XLSX files.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: needle-ai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/needle-ai/needle-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/needle

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

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- 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
- Create a new collection called Architecture Notes
- Index the documentation page at https://needle.app
- Search the collection for details on authentication flow

## Similar
- [Cloudflare AutoRAG](https://affpapa.org/en/nevibecode/mcp/cloudflare-autorag.md) — MCP server
- [rag-construction](https://affpapa.org/en/nevibecode/skills/rag-construction.md) — skill · 123 installs
- [mcp-local-rag](https://affpapa.org/en/nevibecode/mcp/mcp-local-rag.md) — MCP server · ★ 436 repo stars
- [pdf-mcp](https://affpapa.org/en/nevibecode/mcp/pdf-mcp.md) — MCP server · ★ 174 repo stars
- [rag-mcp](https://affpapa.org/en/nevibecode/mcp/rag-mcp.md) — MCP server · ★ 9 repo stars
- [Urantia Papers](https://affpapa.org/en/nevibecode/mcp/urantiahub-urantia-papers.md) — MCP server · 2382 installs

## Other versions with the same name
- [Needle · useneedle-net](https://affpapa.org/en/nevibecode/mcp/useneedle-net-needle.md) — ★ 1 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
