Needle MCP Server logo

Needle MCP Server

by MCP-Mirror

The Needle MCP server manages documents and performs semantic search through Claude chat using Needle. It allows users to interact with their document collections directly from Claude.

View on GitHub

Last updated: N/A

What is Needle MCP Server?

The Needle MCP server is a tool that enables you to manage document collections and perform semantic searches within those collections using the Claude chat interface. It acts as a bridge between Claude and the Needle platform.

How to use Needle MCP Server?

To use the server, you need to clone the repository, install UV, configure the claude_desktop_config.json file with the correct paths and your Needle API key, and then restart Claude. You can then use natural language commands within Claude to create collections, add documents, search, and list collections.

Key features of Needle MCP Server

  • Document Collection Management

  • Semantic Search

  • Integration with Claude Chat

  • Command-line Interface

  • API Key Authentication

Use cases of Needle MCP Server

  • Searching technical documentation

  • Managing research papers

  • Finding specific information within a large document set

  • Integrating knowledge bases with Claude

FAQ from Needle MCP Server

How do I install UV?

Install UV globally using Homebrew with the command brew install uv.

Where do I find the claude_desktop_config.json file?

On MacOS, it's located in ~/Library/Application Support/Claude/. On Windows, it's in %APPDATA%/Claude/.

Where do I get my Needle API key?

You can get your Needle API key from needle.xyz.

What do I do if the integration isn't working?

Make sure UV is installed globally, the Needle API key is correct, and the needle-mcp path in the config matches your actual repository location. You can also try resetting the Claude Desktop configuration.

What are some example commands I can use?

You can use commands like 'Create a new collection called 'Technical Docs'', 'Add this document to the collection, which is https://needle-ai.com', 'Search the collection for information about AI', and 'List all my collections'.