Home/Documentation
GuideClaude Desktop

Claude Desktop Setup with MemoAir

Connect Claude Desktop to MemoAir so Claude can search and save memory through MCP. The fastest path uses MemoAir's local installer helper, with a direct terminal install and manual JSON fallback if needed.

Why this flow exists

Claude Desktop loads MCP servers from a local config file on your machine.

MemoAir uses a small local helper so the dashboard can update that config for you.

If the helper is blocked or unavailable, you can still install through a direct command or manual JSON.

Setup

Four short steps.

1

Get your MemoAir credentials

Open dashboard.memoair.space and copy your MCP URL, project API key, and user ID.

2

Start the local installer helper

Run this on the same machine as Claude Desktop:

1npx -p memoair-mcp memoair-connect bridge

Leave that process running while you install from the dashboard.

3

Install from the dashboard

Go to the Connected Apps section, choose Claude Desktop, and click install once the helper is detected.

If the helper is unavailable, use the direct terminal installer instead:

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"
4

Verify the connection

Restart Claude Desktop, open a chat, click the + button, then check Connectors to confirm MemoAir is available.

Manual JSON fallback

If you prefer editing the config yourself, add MemoAir to Claude Desktop's config file.

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}

Troubleshooting

Helper not detected

Make sure `memoair-connect bridge` is still running and your browser can reach the local helper. If not, use the direct install command instead.

MemoAir doesn’t appear in Claude

Restart Claude Desktop completely after installation so it reloads the MCP config.

Authentication fails

Regenerate the project API key from the dashboard and update the config or rerun the installer command.

Need the shared MCP reference too?

The full MCP setup page also covers Claude Code, Cursor, and manual integration details.