English Français العربية

Airweave Search

Official registry Archived Search and web

MCP server for searching Airweave collections with natural language queries.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http airweave-search 'https://mcp.airweave.ai/mcp' --header 'X-API-Key: <Your Airweave API key>' --header 'X-Collection-Readable-ID: <The Airweave collection readable ID to search>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "airweave-search": {
            "type": "http",
            "url": "https://mcp.airweave.ai/mcp",
            "headers": {
                "X-API-Key": "<Your Airweave API key>",
                "X-Collection-Readable-ID": "<The Airweave collection readable ID to search>"
            }
        }
    }
}
NPM package airweave-mcp-search
Claude Code 
claude mcp add airweave-search -e 'AIRWEAVE_API_KEY=<your airweave_api_key>' -e 'AIRWEAVE_COLLECTION=<AIRWEAVE_COLLECTION>' -e 'AIRWEAVE_BASE_URL=<AIRWEAVE_BASE_URL>' -- npx -y airweave-mcp-search@0.9.62
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "airweave-search": {
            "command": "npx",
            "args": [
                "-y",
                "airweave-mcp-search@0.9.62"
            ],
            "env": {
                "AIRWEAVE_API_KEY": "<your airweave_api_key>",
                "AIRWEAVE_COLLECTION": "<AIRWEAVE_COLLECTION>",
                "AIRWEAVE_BASE_URL": "<AIRWEAVE_BASE_URL>"
            }
        }
    }
}

Environment variables

  • AIRWEAVE_API_KEY required secret Your Airweave API key for authentication
  • AIRWEAVE_COLLECTION required The Airweave collection to search
  • AIRWEAVE_BASE_URL Airweave API base URL (defaults to https://api.airweave.ai)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Quickstart
  2. Supported Integrations
  3. SDKs
  4. CLI
  5. Tech Stack
  6. Contributing
  7. License

Open-source context retrieval layer for AI agents and RAG systems.

What is Airweave?

Airweave connects to your apps, tools, and databases, continuously syncs their data, and exposes it through a unified, LLM-friendly search interface. AI agents query Airweave to retrieve relevant, grounded, up-to-date context from multiple sources in a single request.

Where it fits

Airweave sits between your data sources and AI systems as shared retrieval infrastructure. It handles authentication, ingestion, syncing, indexing, and retrieval so you don't have to rebuild fragile pipelines for every agent or integration.

How it works
  1. Connect your apps, databases, and documents (50+ integrations)
  2. Airweave syncs, indexes, and exposes your data through a unified retrieval layer
  3. Agents query Airweave via our SDKs, REST API, MCP, or native integrations with popular agent frameworks
  4. Agents retrieve relevant, grounded context on demand

Quickstart

Cloud-hosted: app.airweave.ai
Self-hosted
git clone https://github.com/airweave-ai/airweave.git
cd airweave
./start.sh

→ http://localhost:8080

Requires Docker and docker-compose

Supported Integrations

SDKs

pip install airweave-sdk        # Python
npm install @airweave/sdk       # TypeScript
from airweave import AirweaveSDK

client = AirweaveSDK(api_key="YOUR_API_KEY")
results = client.collections.search.instant(
    readable_id="my-collection",
    query="Find recent failed payments"
)

CLI

Search collections, manage sources, and trigger syncs from your terminal:

pip install airweave-cli
airweave auth login
airweave search "quarterly revenue figures" --collection finance-data

The CLI outputs rich interactive results in your terminal and clean JSON when piped — making it work for both developers and AI agents.

Tech Stack

Contributing

We welcome contributions! See our Contributing Guide.

License

MIT License

Discord · Issues · Twitter

Frequently asked questions

What is Airweave Search?

MCP server for searching Airweave collections with natural language queries.

How do I install Airweave Search?

It runs as a remote server. In Claude Code: claude mcp add --transport http airweave-search 'https://mcp.airweave.ai/mcp' --header 'X-API-Key: <Your Airweave API key>' --header 'X-Collection-Readable-ID: <The Airweave collection readable ID to search>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Airweave Search need an API key?

Yes. It expects AIRWEAVE_API_KEY, AIRWEAVE_COLLECTION, X-API-Key, X-Collection-Readable-ID, which you set in its configuration.

Is Airweave Search open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Airweave Search?

It is published by airweave-ai. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.