substrate-memory
OfficialThis server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Claude Co-work Substrate Memory
Beta — stdio transport unverified in the Co-work sandbox. The plugin format is verified against Anthropic's cached Co-work authoring skill, but its stdio MCP execution environment in Co-work's VM sandbox is not verified. A human must install the .plugin, open a Co-work session, and confirm substrate_status returns before support is claimed.
Substrate Memory gives Claude Co-work seven MCP tools for searching and recording organizational memory. Capture is skill-driven: the bundled skill directs Claude to search prior work before answering, remember durable user facts and decisions, and sync at natural session boundaries. Hooks are a best-effort bonus only and may never fire in Co-work.
Install
Package the repository as a
.pluginfile as described in docs/packaging.md.Install the
.pluginfile in Claude Co-work.Set the environment variables below in the process that launches Co-work.
Start a session and run
substrate_status.
Related MCP server: Cornerstone MCP Server
Configuration
Set these secrets in the process environment only:
SUBSTRATE_API_URL=https://api.substrate.example
SUBSTRATE_API_KEY=...SUBSTRATE_API_KEY is never written to a config file. Host config files are world-readable plaintext. SUBSTRATE_PYTHON optionally overrides the python executable used for the stdio server.
Sandbox consequences and mitigations:
A loopback
http://127.0.0.1Substrate URL may not resolve from the Co-work sandbox; use an HTTPS URL.pythonmay not be on the sandboxPATH; setSUBSTRATE_PYTHONto an available executable..mcp.jsonalso supports an{"type":"http","url":...}transport as an alternative when a hosted MCP endpoint is available.
Tools
substrate_search— search cited organizational memory cards.substrate_read— read a wiki page by path.substrate_query— ask for a cited synthesis.substrate_ingest— submit text for ingestion.substrate_remember— record a durable fact, decision, or preference.substrate_sync— flush the durable local spool.substrate_status— report content-free configuration and delivery status.
Privacy boundary
The plugin reads API credentials from the process environment only, redacts captured text before persistence or transfer, and emits content-free operational diagnostics. It does not read Co-work transcripts; hook events contain only a session boundary signal. Report vulnerabilities through GitHub private security advisories.
See BOUNDARY.md and SECURITY.md for the public commitment and security policy.
Repository map
skills/— the primary Co-work capture instructions and tool reference.src/claude_cowork_memory/— Co-work runtime, MCP server, hook, and CLI.src/substrate_capture/— frozen shared client, redaction, spool, event, and MCP core.hooks/— best-effort Stop and SessionEnd integration.tests/— core and plugin contract tests.docs/packaging.md—.plugincreation instructions.
MIT © 2026 Sightline Technologies Inc.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
Persistent memory for AI assistants. Save once; recall from Claude, ChatGPT, or any MCP client.
Cross-tool persistent memory and context for AI assistants over MCP.
Hosted agent memory: store, search, and recall facts across sessions from any MCP client.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server providing persistent, searchable memory management for AI workflows, enabling Claude Code to store, retrieve, and organize context through CRUD operations and knowledge tools.MIT
- FlicenseNot gradedqualityDmaintenanceEnables Claude and other MCP clients to interact with Cornerstone memory, supporting saving, searching, and managing contextual data through natural language commands.-
- AlicenseNot gradedqualityCmaintenanceProvides MCP tools for workspace initialization, health checks, context recall, and durable memory capture, enabling project-specific memory and shared company knowledge with citations.MIT
- AlicenseNot gradedqualityCmaintenanceMCP server that connects Claude Code to Substrate organizational memory, providing tools for searching, reading, querying, and writing memory, with automatic capture of conversation turns.MIT