membase
Memory layer for AI agents — SDKs, CLI and MCP server for Membase
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/unibaseio/membase with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/unibaseio/membase'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/unibaseio--membase)HTML
<a href="/listings/unibaseio--membase"><img src="/api/listings/unibaseio--membase/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
<p align="center"> </p>
pip install unibaseio-membase # hosted · Python 3.10+ · needs MEMBASE_API_KEY pip install 'unibaseio-membase[local]' # local · Python 3.12 or 3.13 · needs OPENAI_API_KEY npm install @unibaseio/membase # TypeScript · Node 18+ npm install -g @unibaseio/membase-cli # the `membase` command (hosted) without Python
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](https://docs.membase.ai/build/reference/sdk-quickstart/). The Python package is `unibaseio-membase` (import `membase`); `membase` on PyPI is unrelated.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 153 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <p align="center">
- <img src="https://raw.githubusercontent.com/unibaseio/membase/main/assets/membase-logo.png" width="72" alt="Membase">
- </p>
- <h1 align="center">Membase</h1>
- <p align="center">
- <b>One memory. Every AI. Only yours.</b><br>
- Teach it once. Every AI remembers.
- </p>
- <p align="center">
- <a href="https://pypi.org/project/unibaseio-membase/"><img src="https://img.shields.io/pypi/v/unibaseio-membase?label=pypi" alt="PyPI"></a>
- <a href="https://www.npmjs.com/package/@unibaseio/membase"><img src="https://img.shields.io/npm/v/@unibaseio/membase?label=npm" alt="npm"></a>
- <a href="https://github.com/unibaseio/membase/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT"></a>
- </p>
- <p align="center">
- <a href="https://membase.com">Website</a> ·
- <a href="https://docs.membase.com">Docs</a> ·
- <a href="https://app.membase.com">Web app</a> ·
- <a href="https://discord.gg/nB9EfPGsSf">Discord</a> ·
- <a href="https://x.com/Unibase_AI">X</a>
- </p>
- <p align="center">
- <img src="https://raw.githubusercontent.com/unibaseio/membase/main/assets/hero.svg" width="840" alt="Add sources, manage one memory, use it from every AI and app">
- </p>
- Membase is the memory layer for AI agents. It keeps one memory for everything you and your agents
- know, and every AI you use reads it.
- You stop re-explaining yourself each time you switch models or tools.
- - **Add.** Facts, documents, web pages and chat exports from Claude or ChatGPT go into one memory.
- - **Manage.** Memories keep projects apart; search them, ask them questions, forget what should go.
- - **Use.** Your code, Claude Code, Cursor, Codex and ChatGPT read the same memory through the SDK or MCP.
- This repository is the developer side: Python and TypeScript clients, the `membase` command line
- and an MCP server. The memory lives in your Membase account, which the
- [web app](https://app.membase.com) and browser extension also fill, or on your machine with
- `unibaseio-membase[local]`.
- ## Write once, read from any AI
- <p align="center">
- <img src="https://raw.githubusercontent.com/unibaseio/membase/main/assets/in-action.svg" width="840" alt="Your app writes a memory; any AI reads it, here Claude Code">
- </p>
- Recordings: [Python SDK](https://github.com/unibaseio/membase/blob/main/assets/videos/sdk.mp4) (57 s) ·
- [Claude Code](https://github.com/unibaseio/membase/blob/main/assets/videos/switch-ai.mp4) (1 min 33 s). The answer above is illustrative.
- ## Accuracy
- <p align="center">
- <img src="https://raw.githubusercontent.com/unibaseio/membase/main/assets/results.svg" width="840" alt="LoCoMo 93.1%, LongMemEval_S 92.6%, DMR 92.2%">
- </p>
- 93.1% on LoCoMo, 92.6% on LongMemEval_S and 92.2% on DMR, using about 3× fewer tokens than the full
- history on LoCoMo and 11× fewer on LongMemEval_S. Method and results: [membase.com/research](https://membase.com/research)
- ## Quickstart
- <p align="center">
- <img src="https://raw.githubusercontent.com/unibaseio/membase/main/assets/architecture.svg" width="840" alt="Hosted, local in process, or local over HTTP">
- </p>
- ```bash
- pip install unibaseio-membase # hosted · Python 3.10+ · needs MEMBASE_API_KEY
- pip install 'unibaseio-membase[local]' # local · Python 3.12 or 3.13 · needs OPENAI_API_KEY
- pip install 'unibaseio-membase[media]' # local + photos, videos and audio
- npm install @unibaseio/membase # TypeScript · Node 18+
- npm install -g @unibaseio/membase-cli # the `membase` command (hosted) without Python
- ```
- ```python
- from membase import Membase
- m = Membase() # hosted
- # m = Membase(local=True) # local, in ~/.membase
- m.memories.add("We picked Postgres for the ledger service.") # a fact
- m.search("what database is the ledger on?") # {"items": [...], "partial": [...]}
- m.add("Design notes …", custom_id="design-1") # a document
- m.profile_facts.list() # who the user is (Your profile ticked)
- m.capabilities() # what this key may do, and the rules
- ```
- No call names a Memory: reads cover every Memory the key reaches, and writes land in its write
- target (a key that reaches several Memories and has none is refused with `WriteTargetRequiredError`).
- Ids are typed (`mem_…` a fact, `doc_…` a document, `med_…` a photo or video), lists are
- `{items, has_more, partial}`, and a removal without `confirm=True` raises `ConfirmationRequiredError`.
- Local memory answers the same routes with the same shapes.
- Every method, its REST route and MCP tool, and the access it needs: [SDK reference](https://docs.membase.com/build/reference/sdk-quickstart/).
- Upgrading from 0.3: see the [changelog](https://github.com/unibaseio/membase/blob/main/CHANGELOG.md).
- The Python package is `unibaseio-membase` (import `membase`); `membase` on PyPI is unrelated.
- ## Command line
- ```bash
- membase --local add "We picked Postgres for the ledger"
- membase --local search "what did we pick for the ledger?"
- membase --local memories list
- 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
- membase --local media add ~/Movies/trip.mp4 # shots, speech and speakers
- membase --local media search "someone skiing" # any language
- ```
- Without `--local` (or `--store DIR`, both before the command) commands use the hosted API; `agent`,
- `import` and `serve` need `unibaseio-membase[local]`, and `media add` and `media ask` (local only)
- need `unibaseio-membase[media]`: see [Media memory](docs/reference.md#media-memory). A local store
- with several Memories writes where `MEMBASE_WRITE_TARGET` names.
- ## MCP
- <p align="center">
- <img src="https://raw.githubusercontent.com/unibaseio/membase/main/assets/mcp.svg" width="840" alt="MCP clients, hosted or local server, same tools">
- </p>
- ```bash
- claude mcp add membase -- membase --local mcp # local
- claude mcp add --transport http membase https://api.app.membase.com/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](https://docs.membase.com/connect/).
- Gemini CLI, as an extension (it signs you in on first use; `/mcp auth membase` signs in again):
- ```bash
- gemini extensions install https://github.com/unibaseio/membase
- ```
- Cline: add the server to `cline_mcp_settings.json`; [llms-install.md](llms-install.md) has the
- entry, with and without a developer key.
- ## Docs
- - [SDK reference](https://docs.membase.com/build/reference/sdk-quickstart/): methods, REST routes, MCP tools, access levels
- - [Memory operations](https://docs.membase.com/build/guides/memory-operations/): Memories, facts, documents, media, profile, ask
- - [Authentication](https://docs.membase.com/build/reference/authentication/): keys and what each one can reach
- - [Connect your AI](https://docs.membase.com/connect/): per-client MCP setup
- - [Agent framework integrations](integrations/): LangChain, Microsoft Agent Framework, Dify, Hermes Agent, OpenClaw and Strands Agents
- - [Local engine](https://github.com/unibaseio/membase/blob/main/docs/reference.md): what it stores, `membase serve`, settings
- ## License
- MIT; see [LICENSE](https://github.com/unibaseio/membase/blob/main/LICENSE). `unibaseio-membase[local]` also
- installs unibaseio-membase-core, the compiled engine, under its own Unibase license.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.