Needle MCP server

What is Needle MCP server?

Needle MCP server is an MCP server that enables managing documents and performing semantic search through Claude chat using the Needle platform. It allows users to create collections, add documents, search across collections, and list collections directly from Claude.

How to use Needle MCP server?

1. Clone the repository and install UV globally via Homebrew (brew install uv). 2. Create or edit claude_desktop_config.json in the Claude config directory, adding a needle_mcp entry with the uv command, the repository path, and your Needle API key. 3. Restart Claude Desktop. Then use natural language commands like “Create a new collection called 'Technical Docs'” or “Search the collection for information about AI.”

Key features of Needle MCP server

• Create new collections in Needle from Claude
• Add documents (URLs) to collections
• Perform semantic search across collections
• List all existing collections
• Integrates Needle’s document management into Claude chat

Use cases of Needle MCP server

• Organize technical documentation into searchable collections via chat
• Add web articles to a Needle collection without leaving Claude
• Quickly find relevant information across multiple documents by asking Claude
• List and manage all your Needle collections conversationally

FAQ from Needle MCP server

Where do I put the configuration file?

For MacOS, create claude_desktop_config.json inside ~/Library/Application Support/Claude/. For Windows, use %APPDATA%/Claude/.

How do I get my Needle API key?

Get your Needle API key from needle.xyz.

What runtime does Needle MCP server require?

It requires UV installed globally. Install it with brew install uv on macOS. If UV is not found, you can find its full path with which uv and replace the command in the config.

How do I reset the configuration if it’s not working?

Remove all Claude Desktop data (on Mac: rm -rf ~/Library/Application\ Support/Claude/*), then create a fresh config file with only the Needle MCP entry and restart Claude.

Why might the integration not work?

Common causes: UV not installed globally, incorrect repository path in the config, wrong Needle API key, or stale config files from previous setups.