Getting Started

@memsolus/mcp is the official MCP (Model Context Protocol) server for Memsolus. It gives Claude and other MCP-compatible agents direct access to 17 memory tools — no code required on your end.

Requirements: Node.js 18+ or Bun 1.0+. A Memsolus API key.

Install

Run the MCP server on demand with npx — no global install needed:

npx @memsolus/mcp

Or with Bun:

bunx @memsolus/mcp

For agents that need a persistent process, install it globally:

npm install -g @memsolus/mcp
# or
bun add -g @memsolus/mcp

Configure environment variables

The MCP server is configured entirely via environment variables. You will need your API key at minimum.

Variable	Required	Default	Description
`MEMSOLUS_API_KEY`	Yes	—	Your API key (`msk_live_...` or `msk_test_...`)
`MEMSOLUS_WORKSPACE_ID`	No	—	Default workspace UUID. When set, all operations scope to this workspace automatically.

Get your API key from the Memsolus dashboard. For a general-purpose agent, the key needs at minimum:

memory.read
memory.write
knowledge.read

Add memory.delete if you want the agent to remove memories.

Connect to Claude

Add the MCP server to your agent's configuration file.

Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add:

{
  "mcpServers": {
    "memsolus": {
      "command": "npx",
      "args": ["-y", "@memsolus/mcp"],
      "env": {
        "MEMSOLUS_API_KEY": "msk_live_your_key_here",
        "MEMSOLUS_WORKSPACE_ID": "your-workspace-uuid"
      }
    }
  }
}

Claude Code

Add to your project's .claude/settings.json or mcp.json:

{
  "mcpServers": {
    "memsolus": {
      "command": "npx",
      "args": ["-y", "@memsolus/mcp"],
      "env": {
        "MEMSOLUS_API_KEY": "msk_live_your_key_here",
        "MEMSOLUS_WORKSPACE_ID": "your-workspace-uuid"
      }
    }
  }
}

Alternatively, register via the Claude CLI:

claude mcp add memsolus -e MEMSOLUS_API_KEY=msk_live_... -- npx -y @memsolus/mcp

Bun runner

Replace "command": "npx" and "args": ["-y", "@memsolus/mcp"] with:

{
  "command": "bunx",
  "args": ["@memsolus/mcp"]
}

Verify the connection

Restart Claude Desktop (or reload your agent) after saving the configuration file.

Then ask Claude:

"What Memsolus tools do you have access to?"

Claude should list the 17 available tools. To confirm the connection works end-to-end:

"Store a test memory: 'MCP server is working'."

Claude will call add_memory and confirm the memory was stored.

What Claude can do with Memsolus

Once connected, Claude has access to 17 tools organized in four categories:

Category	Tools	What it enables
Memory Management	9	Store, search, list, update, delete, promote, and review the history of memories
Knowledge	2	Load the consolidated knowledge profile for a user
Graph	3	Search entities, traverse relationships, and ask natural language questions
Utilities	3	Dashboard statistics, user profiles, entity discovery