MCP Server

Serve your Airweave collection over an MCP server so clients like Cursor or Claude can query it.

Prerequisites

Before you start you’ll need:

  • A collection with data: at least one source connection must have completed its initial sync. Follow the Quickstart if you haven’t done this yet.
  • An API key: create one in the Airweave dashboard under API Keys.

Set-up

Requirement: Cursor version 0.45.6 or later

  1. Open Cursor Settings
  2. Go to Features > MCP Servers
  3. Click ”+ Add new global MCP server”
  4. Add this configuration:
Cursor Configuration
1{
2 "mcpServers": {
3 "airweave-search": {
4 "command": "npx",
5 "args": ["-y", "airweave-mcp-search"],
6 "env": {
7 "AIRWEAVE_API_KEY": "your-api-key",
8 "AIRWEAVE_COLLECTION": "your-collection-id"
9 }
10 }
11 }
12}

These environment variables can be set:

  • AIRWEAVE_API_KEY (Required): Authenticates the MCP server with the Airweave API so it can run searches on your behalf.
  • AIRWEAVE_COLLECTION (Required): Readable ID of the collection to query. All search calls are scoped to this collection.
  • AIRWEAVE_BASE_URL (Optional): Override if you’re running a self-hosted Airweave instance (default: https://api.airweave.ai).

Available tools

The MCP server provides two tools:

  • search: search across all source connections in the collection with optional AI completion. See the search endpoint for more details.
  • get-config: View current configuration and connection status to verify everything is working correctly. No parameters required - shows your collection ID, API endpoint, and connection status.