Overview
Needle MCP Server is a Model Context Protocol (MCP) server that lets you organize, store, and rapidly retrieve documents, while enabling semantic search over your data using Claude's large language model. It integrates with the Needle ecosystem and Claude Desktop to facilitate search-driven workflows and management of documents across PDFs, DOCX, XLSX, and other file types. The README positions remote MCP as the recommended deployment for best experience, exposing endpoints: Streamable HTTP at https://mcp.needle.app/mcp and SSE at https://mcp.needle.app/sse (SSE deprecated in the latest spec). You can connect Claude Desktop to the server via configuration blocks that specify the mcpServers needle entry with a command (npx mcp-remote) and an API key. The project also describes a local installation path using uv, a Docker-based setup, and optional installation through Smithery. It includes concrete config examples for Claude Desktop and Cursor, instructions to obtain a Needle API key, and guidance on restarting Claude Desktop. Troubleshooting and reset steps for Claude Desktop configurations are provided. This is a production-ready solution for searching and retrieving data from your own documents using Needle and Claude.
Features
Document Management
Easily add and organize documents on the server.
Search & Retrieval
Claude-based natural language search for quick answers.
Easy Integration
Works with Claude Desktop and Needle collections.




