Documentation

Everything you need to connect MemoryBriefcase to your AI tools.

Quick Start

Create an account at memorybriefcase.com/signup
Create a briefcase from your dashboard and add memory keys
Connect your AI tool via MCP, REST API, or the Chrome extension

MCP Server

For Claude, Cursor, Windsurf, Zed, and any MCP-compatible client

Streamable HTTP (recommended)

{
  "mcpServers": {
    "memorybriefcase": {
      "url": "https://memorybriefcase.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

SSE (legacy clients)

{
  "mcpServers": {
    "memorybriefcase": {
      "url": "https://memorybriefcase.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Available MCP tools

Tool	Description
get_memory	Get a value by dot-notation key
set_memory	Set a key-value pair
delete_memory	Delete a key
list_memory_keys	List all keys in a briefcase
merge_memory	Deep-merge a JSON object into a briefcase
summarize_memory	Get a markdown summary of a briefcase
resolve_context	Semantically retrieve the most relevant context within a token budget
get_history	Return briefcase snapshot history over time

REST API

Base URL: https://memorybriefcase.com

All authenticated endpoints require Authorization: Bearer YOUR_TOKEN header.

GET/api/briefcasesList all your briefcases

POST/api/briefcasesCreate a new briefcase

GET/api/briefcases/:idGet a single briefcase

DELETE/api/briefcases/:idDelete a briefcase

GET/api/briefcases/:id/memoryGet full memory payload

POST/api/briefcases/:id/memorySet a key { key, value }

DELETE/api/briefcases/:id/memoryDelete a key { key }

POST/api/briefcases/:id/memory/mergeDeep-merge a JSON object

GET/api/briefcases/:id/memory/keysList all keys

GET/api/briefcases/:id/summaryGet markdown summary + provider links

GET/api/usageStorage and briefcase usage

Example — set a memory key

curl -X POST https://memorybriefcase.com/api/briefcases/default/memory \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"key": "work.role", "value": "Full-stack Engineer"}'

Authentication

The web app signs in with Firebase (email/password, Google, Apple), then exchanges the Firebase ID token for an app session via /api/auth/firebase. Legacy email/password endpoints remain for older clients and migration.

POST/api/auth/firebaseFirebase ID token (any provider) → { token, user }

POST/api/auth/googleAlias of /api/auth/firebase (backward compatible)

POST/api/auth/registerLegacy register { email, password, fullName? } (non-Firebase)

POST/api/auth/loginLegacy login { email, password } → { token, user }

POST/api/auth/forgot-passwordLegacy server reset token (email not sent in prod unless configured)

POST/api/auth/reset-passwordLegacy reset with server-issued token

POST/api/auth/logoutRevoke current session token

Chrome Extension

The MemoryBriefcase Chrome extension lets you inject your briefcase context directly into ChatGPT, Claude, Gemini, Perplexity, Grok, and Cursor with one click.

Install (developer mode)

Go to chrome://extensions
Enable Developer mode (top right)
Click Load unpacked and select the memorybriefcase-extension folder
Click the extension icon and sign in

Injection formats

Natural — Conversational sentences ("My name is X, I work as Y…")
Markdown — Structured with headers and bullet points
Compact — Dot-notation key: value pairs

Memory Key Format

All memory keys use free-form dot-notation to represent nested structure. There is no fixed namespace whitelist, so you can use whatever fits your context naturally:

Pattern	Example keys
personal	identity.name, travel.home_city
health	health.sleep_goal, health.medications
wealth	wealth.sip.allocations, wealth.plan.target
project	project.api.endpoints, project.debugging.common
work	work.role, work.stack, work.clients
custom	custom.anything, anything.you.need