Advertise
MCP.so
Sign In

Needle MCP server

@MCP-Mirror

Repository

Basic information

Category

Other

Transports

stdio

Author

MCP-Mirror

About Needle MCP server

Mirror of

#needle#mcp-server#semantic-search

Needle MCP server 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": ""
      }
    }
  }
}

Needle MCP server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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?

  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

Frequently asked questions

1

Where do I put the configuration file?

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

2

How do I get my Needle API key?

Get your Needle API key from needle.xyz.

3

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.

4

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.

5

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

More Other MCP servers

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

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
Advertise