home / mcp / marm mcp server

MARM MCP Server

Provides a persistent memory layer and structured session context for MCP clients, enabling cross-session recall and semantic search across AI tools.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "lyellr88-marm-systems": {
      "url": "http://localhost:8001/mcp"
    }
  }
}

You can connect your AI agents to MARM MCP Server to give them persistent memory, cross-session recall, and structured session data. This memory layer sits beneath your AI tools, enabling semantic search, auto-classification, and shared memories across tools and sessions so your agents stay contextually aware and productive.

How to use

Connect your MCP client to the MARM MCP Server using either HTTP or STDIO transport. The HTTP method exposes a remote endpoint you can call over the network, while STDIO runs as a local process that communicates via standard input and output. Once connected, your agents can store memories, logs, notebooks, and session context in a centralized memory store and retrieve them by meaning across sessions and tools.

Typical usage patterns include creating a session for a project, sending logs and decisions as you work, and asking the memory system to surface relevant past notes or summaries when you face a similar task. You can also use semantic search to find related discussions, code snippets, or decisions across multiple tools and sessions.

How to install

Prerequisites: you need Python and Docker installed on your machine. You may also use pip to install Python packages if you choose the Python-based setup.

docker pull lyellr88/marm-mcp-server:latest
docker run -d --name marm-mcp-server -p 8001:8001 -v ~/.marm:/home/marm/.marm lyellr88/marm-mcp-server:latest
claude mcp add --transport http marm-memory http://localhost:8001/mcp

If you prefer a local HTTP install without Docker, run these commands to install and start the server, then connect your MCP client to the HTTP endpoint.

pip install marm-mcp-server==2.2.6
pip install -r marm-mcp-server/requirements.txt
python marm-mcp-server
claude mcp add --transport http marm-memory http://localhost:8001/mcp

For STDIO transport, you run the server as a local process and connect your MCP client to the STDIO stream. The final run command shown is the starting point for STDIO deployments.

pip install marm-mcp-server==2.2.6
pip install -r marm-mcp-server/requirements_stdio.txt
<platform> mcp add --transport stdio marm-memory-stdio python "your/file/path/to/marm-mcp-server/server_stdio.py"
python marm-mcp-server/server_stdio.py

Additional setup options (optional)

If you want to configure authentication or customize how the server is exposed, you can provide a manual HTTP configuration or rely on the STDIO setup where you specify how the client launches the server. STDIO configuration examples show how to run with a specific Python script and path.

<!-- STDIO JSON configuration example used for IDEs and certain MCP clients -->
{
  "mcpServers": {
    "marm-memory-stdio": {
      "command": "python",
      "args": ["marm-mcp-server/server_stdio.py"],
      "cwd": "/path/to/marm-mcp-server"
    }
  }
}

Available tools

marm_smart_recall

AI-powered semantic similarity search across all memories with optional global search.

marm_contextual_log

Intelligent auto-classifying memory storage using vector embeddings.

marm_start

Activate MARM intelligent memory and response accuracy layers.

marm_refresh

Refresh AI agent session state and reaffirm protocol adherence.

marm_log_session

Create or switch to named memory session containers.

marm_log_entry

Add structured log entries with automatic dating.

marm_log_show

Display all memory entries and sessions with filters.

marm_log_delete

Delete specified sessions or individual entries.

marm_summary

Generate context-aware summaries with intelligent truncation.

marm_context_bridge

Smart context bridging for seamless workflow transitions.

marm_notebook_add

Add new notebook entries with semantic embeddings.

marm_notebook_use

Activate notebook entries as instructions.

marm_notebook_show

Display all saved notebook keys and summaries.

marm_notebook_delete

Delete specific notebook entries.

marm_notebook_clear

Clear the active instruction list.

marm_notebook_status

Show the current active instruction list.

marm_current_context

Background tool providing current date/time for log entries.

marm_system_info

Comprehensive system information, health status, and loaded docs.

marm_reload_docs

Reload documentation into memory for fast access.