Build Agents with Needle MCP Server
@needle-ai
About Build Agents with Needle MCP Server
Needle MCP Server for easy RAG.Long-term memory for LLMs.
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"needle-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"needle-mcp",
"--client",
"claude"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Build Agents with Needle MCP Server?
Build Agents with Needle MCP Server is an MCP (Model Context Protocol) server that enables document management and semantic search through the Needle platform, designed for use with Claude Desktop and other MCP-compatible clients. It allows users to organize documents, perform natural language searches, and integrate LLMs with external data sources like PDFs, DOCX, and XLSX.
How to use Build Agents with Needle MCP Server?
Install via the recommended remote server (add to Claude Desktop or Cursor config with your Needle API key) or locally using UV or Docker. After setup, connect in Claude Desktop and use simple text commands like “Create a new collection called ‘Technical Docs’”, “Add this document to the collection”, “Search the collection for information about AI”, or “List all my collections”.
Key features of Build Agents with Needle MCP Server
- Add and organize documents in Needle collections.
- Claude-based natural language search for quick answers.
- Works with Claude Desktop and Cursor.
- Supports remote (Streamable HTTP/SSE) or local deployment.
- Accessible via Smithery for one‑command installation.
Use cases of Build Agents with Needle MCP Server
- Quickly retrieve information from a set of technical PDFs using plain English.
- Build a searchable knowledge base from diverse file formats (DOCX, XLSX, PDF).
- Enable AI assistants to answer questions from private document collections.
- List and manage multiple document collections through a chat interface.
FAQ from Build Agents with Needle MCP Server
How do I install Build Agents with Needle MCP Server?
Several methods: use the remote server via npx mcp-remote https://mcp.needle.app/mcp, install locally with UV (brew install uv and configure Claude Desktop), use Docker (docker build -t needle-mcp), or install via Smithery (npx -y @smithery/cli install needle-mcp --client claude).
Where do I get my Needle API key?
Obtain your API key from the Needle settings page at https://needle.app.
What endpoints are available?
Two endpoints: https://mcp.needle.app/mcp (Streamable HTTP, recommended) and https://mcp.needle.app/sse (SSE, deprecated in the latest MCP spec).
How do I troubleshoot if the server isn’t working?
Ensure uv is installed globally (use brew install uv), verify your Needle API key is correct, confirm the needle-mcp path in your config matches your repository location, and restart Claude Desktop completely.
Which clients are supported?
Claude Desktop is the primary client, with explicit configuration examples provided for Cursor as well.
More Memory & Knowledge MCP servers
Ultimate Google Docs & Drive MCP Server
a-bonusThe Ultimate Google Docs, Sheets, Drive, Gmail, & Google Calendar MCP Server. This MCP (primarily for use in Claude Desktop) gains full access to your google suite and lets claude do its thing.
MCP Apple Notes
RafalWilinskiTalk with your notes in Claude. RAG over your Apple Notes using Model Context Protocol.
Notion MCP Server
suekouA Model Context Protocol server for connecting Notion to MCP-compatible clients
Solomd
zhitongblogA markdown editor — and the bridge to your LLM. Local-first, MIT, ~15 MB. Bundled MCP server lets Claude Code / Codex / Cursor drive your vault directly. 14 AI providers BYOK.
Memory
modelcontextprotocolModel Context Protocol Servers
Comments