Claude Desktop

Add Walrus Memory to Claude Desktop so the agent can save and recall durable facts. Claude Desktop uses the MCP server (the memory tools); the automatic-memory plugin hooks are available on Claude Code, Codex, Cursor, and Antigravity.

Prerequisites

• Node.js 20+
• A Walrus Memory account. The first memory tool call opens a browser sign-in (memwal_login).

Installation

Add the server to your Claude Desktop config:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Source: mcp/claude-desktop.md

{
  "mcpServers": {
    "memwal": {
      "command": "npx",
      "args": ["-y", "@mysten-incubation/memwal-mcp"],
      "env": { "MEMWAL_NAMESPACE": "default" }
    }
  }
}

note

Newer Claude Desktop versions pre-populate claude_desktop_config.json with other top-level keys (such as preferences) and no mcpServers block. Add mcpServers as a sibling of the existing keys rather than replacing the file. If an mcpServers block already exists, add the memwal entry inside it alongside any other servers.

Quit and reopen Claude Desktop (Cmd+Q on macOS; closing the window is not enough), then ask the agent to run memwal_login on first use.

Available tools

Tool	Description
memwal_remember	Save a durable fact (preference, decision, constraint, identity).
memwal_remember_bulk	Save several distinct facts in one call.
memwal_recall	Semantic search across stored memories for relevant context.
memwal_analyze	Extract and save multiple facts from a passage of text.
memwal_restore	Rebuild the search index from Walrus (recovery).
memwal_health	Fast connectivity check.
memwal_login / memwal_logout	Connect or disconnect this client.

The tool descriptions tell the agent to save and recall proactively. See Reference for full parameters.

Verify

Ask the agent what MCP tools it has available. You should see the memwal_* tools. State a durable fact and confirm the agent saves it with memwal_remember.

Troubleshooting

• Tools missing: fully quit and reopen Claude Desktop (Cmd+Q).
• Not signed in: ask the agent to run memwal_login, approve in the browser, then retry.
• memwal_recall returns nothing although you saved before: run memwal_restore <namespace> to rebuild the index from Walrus.