Home/Documentation

⌘K

MCP Server

Model Context Protocol

Connect MemoAir directly to AI assistants like Claude Desktop and Cursor using the Model Context Protocol (MCP). Your AI assistant gains persistent memory that survives across conversations.

What is MCP?

The Model Context Protocol is an open standard that allows AI assistants to connect to external tools and data sources. MemoAir's MCP server gives your AI assistant the ability to search, save, and manage memories.

Benefits: Your AI remembers your preferences, past conversations, and important information across all sessions.

Prerequisites

Node.js 20+ installed
A MemoAir API Key (get one from your dashboard)
Claude Desktop, Claude Code, or Cursor IDE

Installation

The MCP server and setup helpers can be run directly with npx:

1npx -p memoair-mcp memoair-mcp

Or install globally:

1npm install -g memoair-mcp

Configure Claude Desktop

The easiest path is to start MemoAir's local installer helper, then install from the dashboard:

1npx -p memoair-mcp memoair-connect bridge

With the helper running, open the dashboard and use the Claude Desktop install flow. MemoAir will update your Claude Desktop MCP config automatically.

You can also install directly from your terminal:

1npx -p memoair-mcp memoair-connect claude-desktop --mcp-url "https://mcp-server.memoair.space/mcp" --project-api-key "memoair_pk_your_project_key" --user-id "your-user-id"

Manual fallback:

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

Windows: %APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.jsonjson

1{
2  "mcpServers": {
3    "memoair": {
4      "command": "npx",
5      "args": ["-y", "mcp-remote", "https://mcp-server.memoair.space/mcp", "--header", "X-API-Key:${X_API_KEY}", "--header", "X-User-ID:${X_USER_ID}"],
6      "env": {
7        "X_API_KEY": "your-api-key-here",
8        "X_USER_ID": "your-user-id"
9      }
10    }
11  }
12}

Replace your-api-key-here with your actual API key from the dashboard.

Configure Claude Code

Claude Code supports native MCP installation. Run the generated MemoAir command on the machine where Claude Code is installed:

1npx -p memoair-mcp memoair-connect claude-code --mcp-url "https://mcp-server.memoair.space/mcp" --project-api-key "memoair_pk_your_project_key" --user-id "your-user-id" --scope local

Configure Cursor

Cursor supports one-click install from the dashboard, npx setup, and manual configuration.

Cursor Integration Guide

One-click install, smart rules, and full setup walkthrough

Available Tools

Once connected, your AI assistant has access to these memory tools:

search_memories

Search your memory bank for relevant information based on a query.

query (required)limitview

save_memory

Save new information to your memory bank for later retrieval.

content (required)source_urlsource_title

analyze_query

Analyze a statement and automatically determine if it should be saved, updated, or deleted.

query (required)source_urlsource_title

delete_memory

Delete a specific memory by its ID.

id (required)

update_memory

Update an existing memory with new content.

id (required)content (required)

list_working_memory

List items in your working memory (hippocampus), grouped by category.

categoriesinclude_contentlimit

Example Conversation

Here's how your AI assistant uses MemoAir:

👤

"Remember that I prefer TypeScript over JavaScript for new projects."

🤖

I'll save that preference for you.

→ Calling save_memory: "User prefers TypeScript over JavaScript for new projects"

... later in a new conversation ...

👤

"Help me set up a new web project."

🤖

Based on your preferences, I'll set this up with TypeScript...

→ search_memories found: "User prefers TypeScript over JavaScript"

Environment Variables

Variable	Required	Description
MEMOAIR_API_KEY	Required	Your MemoAir API key
MEMOAIR_USER_ID	Optional	User ID for memory isolation (defaults to API key owner)
MEMOAIR_API_BASE	Optional	API base URL (for self-hosted instances)

Troubleshooting

MCP server not appearing in Claude

Restart Claude Desktop after editing the config file. Check the logs at ~/Library/Logs/Claude/ for errors.

Authentication errors

Verify your API key is correct and hasn't expired. Generate a new key from the dashboard if needed.

Tools not working

Ensure Node.js 18+ is installed. Run node --version to check.