MCP Server

Active

MIT

Airweave Search MCP Server

io.github.airweave-ai/search

Query all your synced apps and data sources with natural language, directly from your AI agent.

What is the Airweave Search MCP server?

Airweave Search is an MCP server that lets AI agents query Airweave collections using natural language, returning relevant, grounded context aggregated from 50+ connected apps, databases, and document sources. It exposes Airweave's unified retrieval layer (which handles syncing, indexing, and search across integrations) directly to MCP clients like Claude and Cursor via a remote streamable-HTTP endpoint or an npm-installable server.

Airweave is an open-source context retrieval layer that connects to apps, tools, and databases, continuously syncs their data, and exposes it through a unified, LLM-friendly search interface. The Airweave Search MCP server lets AI agents and RAG systems query these synced "collections" with natural language to retrieve grounded, up-to-date context from multiple sources in a single request, instead of building custom retrieval pipelines per integration.

How to install Airweave Search

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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)
X-API-Key
required
secret
Your Airweave API key
X-Collection-Readable-ID
required
The Airweave collection readable ID to search

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "search": {
      "command": "npx",
      "args": [
        "-y",
        "airweave-mcp-search"
      ],
      "env": {
        "AIRWEAVE_API_KEY": "<YOUR_AIRWEAVE_API_KEY>",
        "AIRWEAVE_COLLECTION": "<YOUR_AIRWEAVE_COLLECTION>",
        "AIRWEAVE_BASE_URL": "<YOUR_AIRWEAVE_BASE_URL>",
        "X-API-Key": "<YOUR_X_API_KEY>",
        "X-Collection-Readable-ID": "<YOUR_X_COLLECTION_READABLE_ID>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

search — Search an Airweave collection using a natural language query and return relevant, grounded context aggregated from connected data sources.

Use cases

Let an AI agent retrieve grounded context (e.g., 'recent failed payments') from synced business systems like Stripe, HubSpot, or Salesforce
Search across documents and wikis (Notion, Confluence, Google Docs, SharePoint) from within an MCP-enabled coding assistant like Claude or Cursor
Query code and issue tracking data (GitHub, GitLab, Jira, Linear) using natural language instead of separate API calls
Build RAG systems that need a single unified search endpoint spanning 50+ connected apps instead of per-source integrations
Retrieve up-to-date context from CRMs, support tools, and file storage (Salesforce, Zendesk, Dropbox, Box) for agent workflows

Airweave Search MCP server FAQ

What does the Airweave Search MCP server do?

It exposes Airweave's collections (data synced from 50+ integrations like Slack, Notion, GitHub, Salesforce, and Google Drive) as a natural-language search tool that AI agents can query over MCP to retrieve grounded, up-to-date context.

Is Airweave Search free to use?

Airweave is open-source under the MIT License and can be self-hosted for free via Docker Compose. A cloud-hosted version is also available at app.airweave.ai; check Airweave's pricing for cloud usage costs.

How do I install it in Cursor or Claude?

You can connect to the remote streamable-HTTP endpoint at https://mcp.airweave.ai/mcp, or install the server locally via the npm package airweave-mcp-search and configure it as an MCP server in your client.

What authentication does it require?

You need an Airweave API key (from app.airweave.ai or a self-hosted instance) and at least one collection with connected, synced data sources before search queries will return results.

Does it require self-hosting Airweave?

No, you can use the hosted cloud version at app.airweave.ai, or self-host by cloning the repo and running ./start.sh with Docker and docker-compose.

What data sources can this search cover?

Any of Airweave's 50+ supported integrations that you've connected and synced into a collection, including Slack, Notion, GitHub, Jira, Salesforce, Gmail, Google Drive, Confluence, HubSpot, and more.

README (reference)

Source of truth, from the repository.

<a href="https://app.airweave.ai" target="_blank" rel="noopener noreferrer"> <picture> <source media="(prefers-color-scheme: dark)" srcset="frontend/public/logo-airweave-darkbg.svg"/> <source media="(prefers-color-scheme: light)" srcset="frontend/public/logo-airweave-lightbg.svg"/> <img width="400" alt="Airweave" src="frontend/public/logo-airweave-darkbg.svg"/> </picture> </a> Open-source context retrieval layer for AI agents and RAG systems. <a href="https://app.airweave.ai" target="_blank"><img src="https://img.shields.io/badge/Airweave_Cloud-0066FF" alt="Airweave Cloud"></a> <a href="https://docs.airweave.ai" target="_blank"><img src="https://img.shields.io/badge/Docs-0066FF" alt="Documentation"></a> <a href="https://x.com/airweave_ai" target="_blank"><img src="https://img.shields.io/twitter/follow/airweave_ai?style=social" alt="Twitter"></a> <a href="https://cursor.com/link/prompt?text=Help%20me%20set%20up%20Airweave%20locally.%20Follow%20these%20steps%3A%0A%0A1.%20First%2C%20verify%20Docker%20is%20installed%20and%20running%3A%0A%20%20%20docker%20--version%0A%20%20%20docker%20info%0A%0A2.%20Clone%20the%20repository%3A%0A%20%20%20git%20clone%20https%3A%2F%2Fgithub.com%2Fairweave-ai%2Fairweave.git%0A%20%20%20cd%20airweave%0A%0A3.%20Start%20Airweave%3A%0A%20%20%20.%2Fstart.sh%0A%0A4.%20The%20script%20will%20automatically%3A%0A%20%20%20-%20Create%20.env%20from%20.env.example%0A%20%20%20-%20Generate%20required%20secrets%20%28ENCRYPTION_KEY%2C%20STATE_SECRET%29%0A%20%20%20-%20Start%20all%20services%20with%20health%20checks%0A%20%20%20-%20Optionally%20prompt%20for%20OpenAI%2FMistral%20API%20keys%0A%0A5.%20Wait%20for%20all%20services%20to%20be%20healthy%20%28this%20may%20take%202-3%20minutes%20on%20first%20run%29%0A%0A6.%20Verify%20the%20app%20is%20accessible%20at%20http%3A%2F%2Flocalhost%3A8080%0A%0AIf%20there%20are%20any%20errors%2C%20help%20me%20troubleshoot%20them.%20Common%20issues%3A%0A-%20Port%20already%20in%20use%20%288080%2C%208001%2C%205432%2C%206333%2C%206379%2C%207233%2C%208081%2C%208088%29%0A-%20Docker%20not%20running%0A-%20Check%20logs%3A%20docker%20logs%20airweave-backend%20or%20docker%20logs%20airweave-frontend%0A%0AUseful%20commands%3A%0A-%20.%2Fstart.sh%20--restart%20%28restart%20services%29%0A-%20.%2Fstart.sh%20--skip-frontend%20%28backend%20only%29%0A-%20.%2Fstart.sh%20--destroy%20%28clean%20up%20everything%29"><img src="https://img.shields.io/badge/Set%20Up%20with-Cursor-000000?logo=cursor&logoColor=white" alt="Set Up with Cursor"></a> <a href="https://github.com/airweave-ai/airweave/actions/workflows/code-quality.yml"><img src="https://github.com/airweave-ai/airweave/actions/workflows/code-quality.yml/badge.svg" alt="Code Quality"></a> <a href="https://github.com/airweave-ai/airweave/actions/workflows/eslint.yml"><img src="https://github.com/airweave-ai/airweave/actions/workflows/eslint.yml/badge.svg" alt="ESLint"></a> <a href="https://github.com/airweave-ai/airweave/actions/workflows/test-public-api.yml"><img src="https://github.com/airweave-ai/airweave/actions/workflows/test-public-api.yml/badge.svg" alt="System Tests"></a> <a href="https://pepy.tech/projects/airweave-sdk"><img src="https://static.pepy.tech/badge/airweave-sdk" alt="PyPI Downloads"></a> <a href="https://discord.gg/gDuebsWGkn"><img src="https://img.shields.io/discord/1323415085011701870?label=Discord&logo=discord&logoColor=white&style=flat-square" alt="Discord"></a> <video width="100%" src="https://github.com/user-attachments/assets/995e4a36-3f88-4d8e-b401-6ca43db0c7bf" controls></video>

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

Connect your apps, databases, and documents (50+ integrations)
Airweave syncs, indexes, and exposes your data through a unified retrieval layer
Agents query Airweave via our SDKs, REST API, MCP, or native integrations with popular agent frameworks
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

<img src="frontend/src/components/icons/apps/airtable.svg" alt="Airtable" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/apollo.svg" alt="Apollo.io" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/asana.svg" alt="Asana" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/attio.svg" alt="Attio" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/bitbucket.svg" alt="Bitbucket" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/box.svg" alt="Box" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/calcom.svg" alt="cal.com" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/clickup.svg" alt="ClickUp" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/coda.svg" alt="Coda" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/confluence.svg" alt="Confluence" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/dropbox.svg" alt="Dropbox" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/intercom.svg" alt="Intercom" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/fireflies.svg" alt="FireFlies" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/freshdesk.svg" alt="Freshdesk" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/github.svg" alt="Github" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/gitlab.svg" alt="Gitlab" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/gmail.svg" alt="Gmail" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/google_calendar.svg" alt="Google Calendar" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/google_docs.svg" alt="Google Docs" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/google_drive.svg" alt="Google Drive" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/hubspot.svg" alt="Hubspot" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/jira.svg" alt="Jira" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/linear.svg" alt="Linear" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/notion.svg" alt="Notion" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/onedrive.svg" alt="Onedrive" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/powerpoint.svg" alt="PowerPoint" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/salesforce.svg" alt="Salesforce" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/servicenow.svg" alt="ServiceNow" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/sharepoint.svg" alt="Sharepoint" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/slab.svg" alt="Slab" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/slack.svg" alt="Slack" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/slite.svg" alt="Slite" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/stripe.svg" alt="Stripe" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/trello.svg" alt="Trello" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/zendesk.svg" alt="Zendesk" width="40" height="40" style="margin: 6px;" /> <img src="frontend/src/components/icons/apps/zoom.svg" alt="Zoom" width="40" height="40" style="margin: 6px;" />  <a href="https://docs.airweave.ai/connectors/overview"><img src="https://img.shields.io/badge/View_all_integrations-0066FF" alt="View all integrations"></a>

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

Frontend: React/TypeScript with ShadCN
Backend: FastAPI (Python)
Databases: PostgreSQL (metadata), Vespa (vectors)
Workers: Temporal (orchestration), Redis (pub/sub)
Deployment: Docker Compose (dev), Kubernetes (prod)

Contributing

We welcome contributions! See our Contributing Guide.

License

MIT License

<a href="https://discord.gg/gDuebsWGkn">Discord</a> · <a href="https://github.com/airweave-ai/airweave/issues">Issues</a> · <a href="https://x.com/airweave_ai">Twitter</a>

Related MCP servers

io.github.aissablk1/mcp-roadmapsh

Active

MCP server for roadmap.sh: roadmaps, best practices, interview questions, projects & progress

TypeScript

MIT

View repository →

AIStatusDashboard

Active

Read-only MCP server for AIStatusDashboard status, incidents, metrics, and fallback recommendations.

TypeScript

MIT

View repository →

AIStorageDepot

Active

Prompt, rules, skills & docs library over MCP. No token = read-only sample of the public library.

JavaScript

MIT

View repository →

io.github.aitools420/onchain-safety-mcp

Maintained

Token-safety for AI agents: rug/honeypot verdict + score across PulseChain, Monad, Base & BSC

JavaScript

MIT

View repository →

io.github.aitor-alt/pixel-squads

MCP Server for Pixel Squads — observe your AI agents as pixel-art characters in a live office

View repository →

io.github.aitorgarcia21/ifg-tax

International tax research — 213 jurisdictions, 500K+ legal documents.

View repository →