MemCell

ai.memcellPublished by memcell.aiOfficial publisherv2.2.1Updated Nov 7, 2026

Shared, persistent memory for AI agents: recall before acting, report outcomes to earn confidence.

VerifiedStreamable HTTPWeb executableKnowledge & MemoryAI & ML

Overview

AI-generated overview

MemCell gives AI assistants a shared, persistent workspace memory: recall instructions and facts before acting, then report outcomes to calibrate confidence.

What you can do
  • Recall durable instructions, decisions, facts, preferences, session threads and knowledge-graph relations before acting
  • Store new knowledge as atomic memories, linked into the workspace knowledge graph
  • Report whether recalled memories worked, failed or were avoided, and rate individual memories to update confidence
  • Ingest PDF, DOCX, CSV, HTML, JSON and Markdown documents into a grounded knowledge base
  • Search document chunks with hybrid semantic and full-text retrieval
  • Inspect workspace telemetry, confidence calibration metrics and governance shield statistics
When to use it
Useful when an assistant should carry context across sessions and clients, follow standing workspace instructions and decisions, or answer from an indexed document set. It fits teams that want memory quality to be measured and improved through outcome feedback rather than stored blindly.
Requirements
A MemCell workspace and an agent key, sent as an Authorization bearer header; the key is created with the memcell connect command or from workspace settings. Runs as a remote streamable HTTP endpoint or locally via npx (Node.js) or a local standalone server with embedded vector storage.
Before you install
The Authorization bearer agent key is a secret granting access to the workspace memory; keep it out of shared configs. The server writes persistent memories and documents into the workspace, and ingested documents and remembered content are stored there. Recall queries are described as ephemeral, but other stored content persists.

Installation

In SourceWeft

  1. Open MemCell in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.memcell%2Fmemcell/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "memcell": {
      "type": "http",
      "url": "https://memcell.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

[MemCell Logo]

MemCell MCP Server

The official Model Context Protocol (MCP) server & registry manifest for MemCell.
Living, persistent memory for AI agents: recall before acting, report outcomes so confidence is earned.

[License: Apache-2.0] [Documentation] [Smithery]

MemCell provides persistent, adaptive memory, working thread continuity, knowledge graph traversal, and grounded document RAG for AI agents across any client harness. This repository contains the official MCP registry manifest, Smithery configuration, and connection guides.


Quickstart

Option A: Local stdio (Recommended)

Run via npx (requires memcell CLI installed or accessible via npm):

bash
npx -y memcell mcp

Option B: Remote Streamable HTTP

Connect directly to the hosted or self-hosted MemCell streamable HTTP endpoint:

  • Endpoint: https://memcell.ai/mcp
  • Header: Authorization: Bearer <agent-key>

Option C: Local Standalone Server (PGlite)

Run MemCell on your local machine with embedded PGlite vector storage (once cached or pointed at MEMCELL_SERVER_PATH, memcell start runs completely offline without network access):

bash
# 1. Start local server in backgroundmemcell start --daemon
# 2. Wire local MCP toolsmemcell connect --url http://localhost:3000

Client Configurations

1. Claude Desktop

Add to claude_desktop_config.json:

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

2. Claude Code

Run:

bash
claude mcp add memcell -- npx -y memcell mcp

3. Cursor

Add to .cursor/mcp.json (or ~/.cursor/mcp.json):

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

4. Antigravity

Add to ~/.gemini/antigravity/mcp_config.json:

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

5. Windsurf / Cline / OpenCode / Goose

Configure the MCP server command as:

  • Command: npx
  • Args: ["-y", "memcell", "mcp"]

How It Works

MemCell exposes seven workspace tools over MCP:

  1. recall: Pre-flight memory retrieval before taking action. Fetches relevant instructions, decisions, facts, preferences, active or resumed session threads, 1-hop knowledge graph relations, and grounded workspace document chunks.
  2. remember: Durable memory storage. Files atomic instructions, decisions, facts, and preferences—including detailed operational specifications (content), affected resources (resources), and enforcement moments (appliesAt)—directly into the active workspace or user profile.
  3. report: Outcome feedback calibration. Reports whether recalled memory worked, failed, or was avoided, calibrating confidence dynamically over time.
  4. feedback: Direct evaluation of a specific memory ID (worked or failed) with supporting outcome notes.
  5. ingest_document: Multi-format document ingestion. Indexes PDF, DOCX, CSV, TSV, HTML, JSON, and Markdown documents into grounded workspace chunks and optionally distills atomic memories.
  6. search_documents: Hybrid semantic and full-text retrieval across grounded workspace document chunks.
  7. get_insights: Live workspace telemetry, empirical Confidence Calibration Curve (ECE, Brier score, and bucketed observed success rates), and Governance Shield metrics (enforced guards, quarantined user-scope memories, and demoted items).

Custom Agent SDK Integrations

Building custom agents in TypeScript or Python? Official drop-in adapters ship inside @memcell/sdk (@memcell/sdk/vercel, @memcell/sdk/openai, @memcell/sdk/langgraph) and Python memcell.integrations (OpenAI Agents, LangGraph, PydanticAI, CrewAI) alongside MCP.


Ecosystem

License

Apache-2.0

Source: README.md at commit c273c96

Tools

7

recall

Ask the workspace's memory before acting. Evaluates intent against durable instructions, decisions, facts, preferences, active session threads, and grounded RAG documents. Zero conversation retention: query text is strictly ephemeral and never stored. Pass the recallId to 'report' so task outcomes sharpen what was recalled.

Parameterstagstypelimitqueryscopeintentscopesmetadata

remember

Record knowledge into MemCell. Accepts raw text, conversational excerpts, or structured hints. MemCell distills material into atomic memories, links them into the workspace Knowledge Graph, and checkpoints session threads.

Parametersrawtypescopetitlecontentcontextlearning

report

Close the recall loop. Reports whether a recalled memory worked, failed, or was avoided in practice. Strengthens what worked and surfaces what failed for correction.

ParametersreasonoutcomerequiredrecallIdmemory_idrecall_idaction_taken

feedback

Evaluate a specific memory after execution: report whether its advice worked or failed in practice. Dynamically updates confidence and appends evidence.

Parametersreasonoutcomerequiredmemory_idrequiredrecall_id

ingest_document

Ingest a PDF, DOCX, CSV, HTML, JSON, or Markdown document into the workspace's grounded knowledge base and optionally distill atomic memories.

ParameterstitlecontentdistillfilenamemimeTypefileBase64

search_documents

Search grounded workspace document chunks (PDF, DOCX, CSV, HTML, JSON, Markdown) using hybrid semantic and full-text retrieval.

Parameterslimitqueryrequired

get_insights

Inspect workspace telemetry, empirical confidence calibration curve (predicted confidence vs observed worked rate, ECE, and Brier score), and governance shield metrics (enforced guards, quarantined user-scope memories, and demoted items).

Parameterstimeframe

Version history

7
  1. v2.2.1LatestNov 4, 2026
  2. v2.1.1Nov 1, 2026
  3. v2.1.0Nov 1, 2026
  4. v2.0.2Nov 1, 2026
  5. v2.0.0Oct 31, 2026
  6. v1.7.1Oct 29, 2026
  7. v0.8.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts