memorybase

CLI and MCP stdio server for MemoryBase.

About MemoryBase

Your AI tools don't talk to each other.

Every time you switch between AI conversations, you start over. Re-explaining your role, your projects, how you like things done. MemoryBase fixes that.

One searchable memory across ChatGPT and Claude, automatically injected into every conversation so responses feel tailored to you.

Sign in

memorybase login

1. The CLI prints a verification URL and a short user code, then tries to open your browser.
2. Sign in on the web page (email OTP today; Google/GitHub once configured).
3. Click Connect device to approve the request.
4. The CLI picks up the bearer token automatically.

The token is stored at $XDG_CONFIG_HOME/memorybase/config.json (Linux/macOS) or %APPDATA%/memorybase/config.json (Windows) with 0600 perms.

Flags:

• --no-browser — print the URL without trying to launch a browser (useful over SSH; open the URL on any device).
• --client-id <id> — override the device-flow client id (default memorybase-cli).

The CLI talks to https://api.memorybase.app by default. To point at a different backend (e.g. local dev), pass --server at login time — the URL is baked into config.json and reused by every subsequent command.

CLI commands

| Command | Purpose | | ---------------------------------- | ---------------------------------------------------- | | memorybase login | sign in via browser (device authorization flow) | | memorybase logout | clear local credentials | | memorybase whoami | show authenticated user | | memorybase status | memory indexing stats | | memorybase search <query> | semantic memory search with extension-parity scoring | | memorybase projects list | list projects | | memorybase project <id> [--pack] | show project, optionally as markdown context pack |

MCP server

Start the MCP stdio server for a host to spawn:

memorybase mcp

Claude Desktop

Add to ~/.config/Claude/claude_desktop_config.json (or the macOS/Windows equivalent):

{
	"mcpServers": {
		"memorybase": {
			"command": "npx",
			"args": ["-y", "memorybase", "mcp"]
		}
	}
}

The MCP server reads the same config file as the CLI — authenticate once via memorybase login in a terminal before starting the host.

Exposed tools

| Tool | What it does | | ---------------------------------------- | ------------------------------------------------------------ | | search_memory | vector search over memory, parity with the browser extension | | memory_status | counts, embedding version, last indexed | | list_projects | user projects | | get_project_context | assembled context pack (markdown default, JSON optional) | | list_conversations | captured AI conversations | | get_conversation | one conversation + messages | | get_timeline / get_timeline_for_date | activity timeline | | search_text | PostgreSQL full-text search (lightweight alternative) |