# needle-mcp

> MCP Server

This repository provides the Needle MCP Server, enabling document management and Claude-powered searches through Claudie Desktop. It integrates with the Needle ecosystem for advanced document handling and retrieval.

## Overview

- **Category:** Search & Knowledge
- **Language:** Python
- **Stars:** 99
- **Forks:** 14
- **Owner:** needle-ai
- **GitHub:** https://github.com/needle-ai/needle-mcp
- **Created:** 2024-12-15T14:25:13+00:00
- **Updated:** 2025-03-26T20:16:48+00:00
- **Source:** https://model-context-protocol.com/servers/needle-integration-modelcontextprotocol-document-search

## Setup

## Setup

1. Clone the repository:
```bash
git clone https://github.com/yourusername/needle-mcp.git
```

2. Install UV globally using Homebrew in Terminal:
```bash
brew install uv
```

3. Create claude_desktop_config.json:
   - For MacOS: Open directory `~/Library/Application Support/Claude/` and create the file inside it
   - For Windows: Open directory `%APPDATA%/Claude/` and create the file inside it

4. Add this configuration to claude_desktop_config.json:
```json
{
  "mcpServers": {
    "needle_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/needle-mcp",
        "run",
        "needle-mcp"
      ],
      "env": {
        "NEEDLE_API_KEY": "your_needle_api_key"
      }
    }
  }
}
```

5. Get your Needle API key from needle.xyz

6. Update the config file:
   - Replace `/path/to/needle-mcp` with your actual repository path
   - Add your Needle API key

7. Quit Claude completely and reopen it

## Tools

## Available Tools

1. Document Management: Easily add and organize documents on the server.
2. Search & Retrieval: Claude-based natural language search for quick answers.
3. Easy Integration: Works with Claudie Desktop and Needle collections.