Skip to main content
The Membase Claude Code plugin is the recommended way to use Membase in Claude Code. It runs locally with Claude Code, connects to your Membase Cloud account through OAuth, and exposes memory and wiki workflows through both slash commands and MCP tools.
1

Install the Membase Claude Code plugin

claude plugin marketplace add aristoapp/claude-membase && claude plugin install membase@membase-plugins
2

Load the plugin in Claude Code

Open Claude Code. If Claude Code is already open, run:
/reload-plugins
3

Connect your Membase account

In Claude Code, run:
/membase:login
The login flow opens browser OAuth and asks you to choose an auto-capture mode:
  • summary: enable summary auto-capture for bounded tool summaries and Claude compact summaries
  • off: disable hook-based summary capture
4

Verify the connection

Run:
/membase:status
Confirm the connected account before saving memory or wiki data.

​
What the Plugin Adds

  • Slash commands: /membase:login, /membase:status, /membase:recall, /membase:remember, /membase:wiki, /membase:index-project, and /membase:project-config
  • Automatic recall: Searches Membase before prompts when auto-recall is enabled and injects relevant context as untrusted reference data
  • Wiki retrieval: Lets Claude Code search, add, update, and delete factual wiki documents through Membase tools
  • Hooks: Supports session start context, prompt-time recall, and opt-in summary capture for durable decisions
  • Project-aware workflows: Can scope memories to the current git repository when project mode is enabled
  • Local credential storage: OAuth tokens are stored in Claude Code’s plugin data directory, not in plugin user settings
Auto-capture only controls hook-based summary capture; Claude can still write memories or wiki docs through Membase tools when appropriate.

​
MCP Fallback

If Claude Code plugins are not available in your environment, you can still connect Membase as a standard MCP server: 
npx -y membase@latest --client claude-code
The MCP fallback provides the core memory and wiki tools, but it does not include Claude Code plugin slash commands, hooks, or project-aware workflows.

​
Troubleshooting

Run /reload-plugins inside Claude Code. If the commands still do not appear, run claude plugin marketplace add aristoapp/claude-membase && claude plugin install membase@membase-plugins again and start a new Claude Code session.
Run /membase:logout, then /membase:login and verify the account with /membase:status. For the cleanest context after switching accounts, run /clear or start a new Claude Code session.
Keep the Claude Code plugin as the primary path. You can leave the remote MCP setup as a fallback, but if duplicate tools are confusing, remove the older MCP configuration after confirming the plugin works.

​
Next Steps

Bring Your Context

Import chat history, connect apps, and more.

Use Your Context

Chat with Memory, agent retrieval, and dashboard exploration.

Knowledge Wiki

Store factual knowledge alongside your memories.

Membase MCP

See every MCP tool your agent can call.