Membase

membase-ai

One memory. Every AI.
Drop-in memory infrastructure for AI agents and apps — the Membase SDK.

Sources go into one memory that every AI and app reads

The Membase SDK: a Python client, the membase command line, an MCP server and a TypeScript client. The memory lives in your Membase account or on your machine, behind the same API.

Write once, read from any AI

Your app writes a memory; any AI reads it, here Claude Code

Recordings: Python SDK (57 s) · Claude Code (1 min 33 s). The answer above is illustrative.

Accuracy

LoCoMo 93.1%, LongMemEval_S 92.6%, DMR 92.2%

On three public long-term memory benchmarks, with a few thousand tokens of context per question.

Quickstart

Hosted, local in process, or local over HTTP

pip install membase-ai              # hosted · Python 3.10+ · needs MEMBASE_API_KEY
pip install 'membase-ai[local]'     # local  · Python 3.12 or 3.13 · needs OPENAI_API_KEY
npm install membase-ai              # TypeScript · Node 18+

from membase import Membase

m = Membase()                    # hosted
# m = Membase(local=True)        # local, in ~/.membase

m.memories.add("We picked Postgres for the ledger service.", container="Engineering")
m.search("what database is the ledger on?")
m.add("Design notes …", container="Engineering", custom_id="design-1")   # a document
m.ask("Which database did we choose for the ledger?")

Every method, its REST route and MCP tool, and the access it needs: SDK reference. The package is membase-ai; membase on PyPI is unrelated.

Command line

membase --local add "We picked Postgres for the ledger" --container Engineering
membase --local search "what did we pick for the ledger?"
membase --local ask "Which database is the ledger on?"
membase --local import ~/Downloads/claude-export.json     # Claude, ChatGPT, markdown or JSON chats
membase --local agent ingest trace.json --agent coder
membase --local agent search "fix flaky deploy" --agent coder

Without --local (or --store DIR, both before the command) commands use the hosted API; agent, import and serve need membase-ai[local].

MCP

MCP clients, hosted or local server, same tools

claude mcp add membase -- membase --local mcp                                   # local
claude mcp add --transport http membase https://api.app.membase.io/mcp-http \
  --header "Authorization: Bearer $MEMBASE_API_KEY"                             # hosted

Hosted without the header, the connection signs you in and is read-only. Setup for Claude, ChatGPT, Cursor, Codex and other clients: Connect your AI.

Docs

SDK reference: methods, REST routes, MCP tools, access levels
Memory operations: containers, documents, memories, profile, ask
Authentication: keys and what each one can reach
Connect your AI: per-client MCP setup
Local engine: what it stores, membase serve, settings

License

MIT. membase-ai[local] also installs membase-core, the compiled engine, under Unibase's proprietary license.

Metadata

Release files for membase-ai 0.2.21

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for membase-ai 0.2.21
File	Size	Uploaded
membase_ai-0.2.21.tar.gz	25.0 kB	Oct 6, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for membase-ai 0.2.21
File	Interpreter	ABI	Platform	Reset
membase_ai-0.2.21-py3-none-any.whl 30.1 kB Oct 6, 2026	Python 3	none	any	Details

Total release size: 55.1 kB

Release files / membase_ai-0.2.21.tar.gz

Download URL	membase_ai-0.2.21.tar.gz
Size	25.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`1a6bf012aa6c1c5f0a30bcf2197c856e7860f617a4312d4c81d2d168dc2db4b4`
BLAKE2b-256 checksum How to use checksums	`fa56adf291a65c572d96c41269f0da0a4c30e5955599647ae9664a00f4e786a0`
Upload date	Oct 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.12`

Release files / membase_ai-0.2.21-py3-none-any.whl

Download URL	membase_ai-0.2.21-py3-none-any.whl
Size	30.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9de7c79ba677e4affc17bc8f931a78209f59516bde4aede4574c9bd9b63acd22`
BLAKE2b-256 checksum How to use checksums	`52337b13366734e82554aa15269827dd479e97f13484a56606f275335fe2efc0`
Upload date	Oct 6, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.12`