needle-mcp

needle-mcp

44
file_systemsdeveloper_tools

Needle MCP Server is designed to manage and search documents using Claude's language capabilities. It integrates with Claude Desktop for easy document organization and retrieval, enhancing productivity with its natural language processing features.

Overview

Needle MCP Server allows you to:

  • Organize and store documents for quick retrieval.
  • Perform powerful searches via Claude’s large language model.
  • Integrate seamlessly with the Needle ecosystem for advanced document management.

Features

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

Usage

Commands in Claude Desktop

  1. Open Claude Desktop and connect to the Needle MCP Server.
  2. Use simple text commands to search, retrieve, or modify documents.
  3. Review search results returned by Claude in a user-friendly interface.

Installation

Installing via Smithery

To install Needle MCP for Claude Desktop automatically via Smithery:

Manual Installation

  1. Clone the repository
  2. Install UV globally using Homebrew in Terminal
  3. Create claude_desktop_config.json
  4. Add configuration to claude_desktop_config.json
  5. Get your Needle API key from needle.xyz
  6. Update the config file
  7. Quit Claude completely and reopen it

Troubleshooting

If not working:

  • Ensure UV is installed globally
  • Verify your Needle API key is correct
  • Check if the needle-mcp path in config matches your actual repository location

Reset Claude Desktop Configuration

  1. Find all Claude Desktop config files
  2. Remove all Claude Desktop data
  3. Create a fresh config with only Needle
  4. Completely quit Claude Desktop and relaunch it