# Needle

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

- **Category:** artificial intelligence
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 16
- **Triggers:** 0
- **Slug:** `NEEDLE`
- **Version:** 20260429_00

## Tools

### Add files to a collection

**Slug:** `NEEDLE_ADD_FILES_TO_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

**Slug:** `NEEDLE_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

**Slug:** `NEEDLE_CREATE_COLLECTION`

Tool to create a new collection. Use after confirming the collection name.

### Create Local Connector

**Slug:** `NEEDLE_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

**Slug:** `NEEDLE_DELETE_FILES_FROM_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

**Slug:** `NEEDLE_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

**Slug:** `NEEDLE_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

**Slug:** `NEEDLE_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 collections, not an error.

### Get File Download URL

**Slug:** `NEEDLE_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 expires quickly.

### Get File Upload URL

**Slug:** `NEEDLE_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 content types can be specified to generate multiple upload URLs in a single request.

### Get local connector

**Slug:** `NEEDLE_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

**Slug:** `NEEDLE_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 ID and need to retrieve its files. Supports pagination.

### List Collections

**Slug:** `NEEDLE_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 operations.

### List Connectors

**Slug:** `NEEDLE_LIST_CONNECTORS`

Tool to list connectors. Use to retrieve all configured connectors in your account.

### List Local Connectors

**Slug:** `NEEDLE_LIST_LOCAL_CONNECTORS`

Tool to list local connectors. Use to retrieve all local connectors configured in your Needle account.

### Search Collection

**Slug:** `NEEDLE_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.