MARM Systems

v1.0.0Knowledge & Memorystable

Stop re-explaining yourself to your AI. MARM gives every session persistent memory, cross-agent context sharing, and structured reasoning that builds as you work, not resets. Includes a live web dashboard for browsing memories, logs, and sessions wit

claudeclaude-codedeveloper-toolsdocker-imageembeddings
Share:
290
Stars
0
Downloads
0
Weekly
0/5

What is MARM Systems?

MARM Systems is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to stop re-explaining yourself to your ai. marm gives every session persistent memory, cross-agent context sharing, and structured reasoning that builds as you work, not resets. includes a live web dashb...

Stop re-explaining yourself to your AI. MARM gives every session persistent memory, cross-agent context sharing, and structured reasoning that builds as you work, not resets. Includes a live web dashboard for browsing memories, logs, and sessions wit

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Stop re-explaining yourself to your AI. MARM gives every ses

Use Cases

Maintain persistent memory across multiple AI sessions.
Share context between different agents and work sessions.
Build structured reasoning that accumulates over time.
Lyellr88

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx marm-systems

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MARM Systems

MARM Systems is a persistent memory MCP server designed to give AI agents durable, cross-session recall so that context built in one conversation is available in future sessions without re-explanation. Using semantic embeddings and a named session model, it allows agents to store structured logs, search past memories with hybrid keyword and vector retrieval, and share a common knowledge base across multiple agents running in parallel. It is especially valuable for developers running long-lived projects with Claude Code or other MCP-compatible tools.

Prerequisites

  • Python 3.10+ and pip installed, or Docker for containerized deployment
  • An MCP-compatible client such as Claude Desktop or Claude Code
  • A generated MARM API key for HTTP/Docker deployments
  • Optional: Ollama for local embedding model support
1

Install the MARM server package

Install from PyPI for local stdio usage. The pip package provides the marm-mcp-stdio command used in stdio transport mode.

pip install marm-mcp-server
2

Generate an API key for HTTP mode (optional)

If you prefer to run MARM as a Docker HTTP server for multi-agent support, generate a secure API key.

docker run --rm lyellr88/marm-mcp-server:latest --generate-key
3

Run MARM as a Docker HTTP server

Start the container with the generated key, binding the data directory and exposing port 8001.

docker run -d --name marm-mcp-server \
  -p 127.0.0.1:8001:8001 \
  -e SERVER_HOST=0.0.0.0 \
  -e MARM_API_KEY=your-generated-key \
  -v ~/.marm:/home/marm/.marm \
  lyellr88/marm-mcp-server:latest
4

Configure your MCP client

Add MARM to your claude_desktop_config.json or Claude Code settings. Use the stdio command for local installs or an HTTP URL for Docker.

5

Start storing memories

Converse naturally — MARM's nine tools (marm_smart_recall, marm_context_log, marm_log_session, etc.) are invoked automatically based on what you ask the agent.

MARM Systems Examples

Client configuration (stdio)

Minimal Claude Desktop config for the pip-installed stdio server.

{
  "mcpServers": {
    "marm-systems": {
      "command": "marm-mcp-stdio",
      "args": []
    }
  }
}

Client configuration (Docker HTTP)

Claude Desktop config for the Docker HTTP deployment with Bearer authentication.

{
  "mcpServers": {
    "marm-systems": {
      "url": "http://localhost:8001/mcp",
      "headers": {
        "Authorization": "Bearer your-generated-key"
      }
    }
  }
}

Prompts to try

Natural language prompts that trigger MARM's memory tools automatically.

- "Log this session as 'Sprint 12' and record that we finalized the API schema"
- "Search your memory for our discussion about the authentication flow"
- "Show me all entries in the current session"
- "Summarize everything stored in my 'Project Beta' session"
- "Remember this SQL migration script in your notebook"

Troubleshooting MARM Systems

marm-mcp-stdio command not found after pip install

Ensure the Python scripts directory is in your PATH. Run pip show marm-mcp-server to see the install location, then add that bin directory to PATH. Using a virtual environment and activating it before running solves this on most systems.

Docker container shows 401 Unauthorized in MCP client

Confirm the Authorization header value matches the key generated by --generate-key exactly. Regenerate with: docker run --rm lyellr88/marm-mcp-server:latest --generate-key and update both the container env var and the client config.

Memories disappear after Docker container is removed

Always mount the data volume with -v ~/.marm:/home/marm/.marm. Without this mount the database is stored inside the container and is lost on removal.

Frequently Asked Questions about MARM Systems

What is MARM Systems?

MARM Systems is a Model Context Protocol (MCP) server that stop re-explaining yourself to your ai. marm gives every session persistent memory, cross-agent context sharing, and structured reasoning that builds as you work, not resets. includes a live web dashboard for browsing memories, logs, and sessions wit It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MARM Systems?

Follow the installation instructions on the MARM Systems GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MARM Systems?

MARM Systems works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MARM Systems free to use?

Yes, MARM Systems is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "marm-systems": { "command": "npx", "args": ["-y", "marm-systems"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MARM Systems?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides