Needle MCP server

@MCP-Mirror

About Needle MCP server

Mirror of

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": ""
      }
    }
  }
}

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 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?

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.

Frequently asked questions

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.

Comments

Basic information

More Other MCP servers

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K