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
Cursor
Claude Desktop
VS Code
Requirement: Cursor version 0.45.6 or later
- Open Cursor Settings
- Go to Features > MCP Servers
- Click ”+ Add new global MCP server”
- Add this configuration:
Cursor Configuration
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. Allsearch
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.