Skip to main content
The Needle MCP Server brings powerful semantic search and document management capabilities to AI agents within your Caylex projects, enabling them to retrieve relevant information from files such as PDFs, DOCX, and XLSX with context-aware precision. Built on the Model Context Protocol, Needle acts as a bridge between your AI agents and document collections (called ‘collections’ in Needle), allowing agents to perform RAG (Retrieval-Augmented Generation) workflows and maintain long-term memory over large document sets. Once connected in Caylex, your agents can search across uploaded documents, manage collections, and surface buried knowledge instantly — without manual file parsing. Authentication is handled via a Needle API key passed as a Bearer token in the Authorization header, which you configure when adding the server to your Caylex project.
Prerequisites:
  • A Needle account is required — obtain your API key from the Needle Settings page at needle.app/dashboard/settings.
  • Documents must be uploaded to Needle collections before agents can search or retrieve them through the MCP server.
Important API details:
  • Authentication requires a valid Needle API key sent as a Bearer token in the Authorization request header.
  • The server supports both SSE and Streamable HTTP transport; the Streamable HTTP endpoint is recommended as SSE has been deprecated in the latest MCP specification.
  • Pagination behavior is supported by the server according to the repository changelog, so large document collections may return results in pages.

​
Server Details

PropertyValue
TransportStreamable HTTP
Server TypeExternal
Endpointhttps://mcp.needle.app/mcp
CategoriesMemory & Knowledge, AI & Machine Learning

​
Authentication

This server supports the following authentication method:

​
Header Authentication

This server authenticates via HTTP headers. During the server onboarding flow, you will be prompted to confirm the required headers. Note that you do not provide the values for the headers during the server on-boarding. Header values are provided by the users during the Auth Link flow.

​
Getting Started

1

Add the server

Navigate to the Server Library and click on the New Server button. Find Needle in the Caylex Catalog.
2

Server Onboarding flow

Go through the server onboarding flow.
3

Use in a project

Add the server to a project by configuring project connections. Its tools are now available to any agents connected to that project.
https://d338mlbnszozgc.cloudfront.net/logos/notion.svg

Notion

https://d338mlbnszozgc.cloudfront.net/logos/google-drive.svg

Google Drive

​
References

https://docs.needle-ai.com/docs/guides/mcp/needle-mcp-server/

https://docs.needle-ai.com/docs/mcp/

https://github.com/needle-ai/needle-mcp