Connect Needle to your AI agent

AI Tools 16 actions available

Needle provides retrieval-augmented generation (RAG) tools that enable semantic search across your data, facilitating the development of AI agents and applications.

We set up the connection using your own Needle account, with keys you control, and keep it running. Your agent picks it up and starts doing the work.

Book a setup call → See pricing
Actions

What your agent can do in Needle

Each one is a real action the agent can take on its own, the same things a person clicking around Needle could do. Read-only by default; write actions are confirmed against your policy.

  • Add files to a collection Tool to add files to a collection by providing file URLs. Use when you need to add one or more files to an existing collection. URLs can be public or private (generated via the Files API).
  • Add Files to Local Connector Tool to add files to a local connector by providing file metadata. Use when you need to add external files to a connector using their URLs.
  • Create Collection Tool to create a new collection. Use after confirming the collection name.
  • Create Local Connector Tool to create a local connector that monitors specified folders on a device. Use when setting up file indexing from a local machine into Needle collections.
  • Delete files from a collection Tool to delete files from a specific collection by providing file IDs. Use after confirming valid file IDs to remove from the collection.
  • Delete files from local connector Tool to delete files from a local connector by filename or file IDs. Use when you need to remove files from a connector's local storage.
  • Get Collection Tool to retrieve details for a specific collection by its ID. Use when you need to get collection metadata including name, creation date, and search query count.
  • Get collection stats Tool to retrieve statistics for a specific collection by its ID. Use when you need document count, index size, and timestamps after confirming the collection exists. Zero document count is a valid response for empty col…
  • Get File Download URL Tool to get a short-lived signed private download URL for a Needle file. Use when you need to retrieve file content but the public storage URL requires authentication. The returned URL should be used immediately as it e…
  • Get File Upload URL Tool to get signed URLs for uploading local files to Needle. Use when you need to upload files to a collection. The upload URLs are valid for a short time, so upload files immediately after receiving the URLs. Multiple…
  • Get local connector Tool to retrieve details of a local connector by its ID. Use when you need information about a specific local connector's configuration, device details, and associated folders.
  • List Collection Files Tool to list all files within a specific collection by its ID. Returns file metadata (including file URLs) only — not document text content; fetch file URLs separately to access content. Use when you have a collection I…
  • List Collections Tool to list collections. Use after authenticating with your API key to page through collections. Similar collection names can exist; always verify the correct `collection_id` from results before performing subsequent o…
  • List Connectors Tool to list connectors. Use to retrieve all configured connectors in your account.
  • List Local Connectors Tool to list local connectors. Use to retrieve all local connectors configured in your Needle account.
  • Search Collection Tool to perform semantic search within a specific Needle collection and return ranked results with source references. Use when you need to retrieve relevant content from a known collection using natural language queries.
Setup

How we connect it

  1. 1

    Connect your account

    You create a key in Needle, a key you create and control, and paste it in once. It lives in a secrets store on your server, not with us.

  2. 2

    Set the guardrails

    Read-only by default. You choose which write actions the agent may take, and anything outside that policy gets confirmed with you first.

  3. 3

    We keep it running

    Health checks on every connection, updates handled for you, and we watch the first week of activity to make sure the work lands.

FAQ

Needle questions, answered.

With a key you create and control. You paste it in once, it is stored in a secrets store on your server, permissions are scoped to the minimum the agent needs, and you can revoke it at any time.
The actions Needle's API allows, the same things a person clicking around the app could do. Connections start read-only by default; write actions are confirmed against the policy you set before the agent takes them.
Connections are priced per tool on top of the base plan. Some are included, some are premium. See pricing for how connection charges work.
Standard tools are ready inside 7 business days of the setup call. We test the connection end to end, walk you through how the agent uses it, and watch the first week of activity.

Ready to put Needle to work?

Tell us what your team runs on. We set up the connection, secure it, and your agent takes it from there.

Book a setup call → Browse all integrations

All product names, logos, and brands are property of their respective owners; used for identification only. ZeroToClaw is not affiliated with or endorsed by Needle.