mesh-memory

Mesh Memory

Mesh Memory is a self-hosted semantic memory service with a built-in MCP server. It stores documents (worklogs, decisions, notes, research) in PostgreSQL with pgvector and retrieves them by meaning, so a query like "what database did we pick?" surfaces a saved note that says "chose Redis for caching" even with zero keyword overlap. Embeddings are generated locally with multilingual-e5-base (768 dimensions); the core flow requires no external API keys.

Use this skill when an agent needs persistent memory across sessions: saving its own work, recalling prior decisions, or building a project knowledge base shared between multiple agents.

When to Use This Skill

• Saving a session worklog, decision, or research note so a later session can find it.
• Recalling past work by topic when you do not remember the exact words you used.
• Sharing a long-lived knowledge base across multiple agents, terminals, or teammates.
• Organizing context by role or project through workspaces (one workspace per role/project).
• Looking up structured tags (e.g. all type:decision entries from one project).

Prerequisites

• A running Mesh Memory instance reachable from the MCP server. Local Docker is the common path -- docker compose up -d in the upstream repo brings it up; see https://github.com/dklymentiev/mesh-memory for the full Quick Start.
• The MCP server (mcp_server.py) registered with your client (Claude Code, Cursor, Claude Desktop, or any other MCP-aware agent).
• MESH_API_URL pointing at the running instance (default: http://localhost:8000).

Setup

Register the MCP server in your client configuration:

{
  "mcpServers": {
    "mesh": {
      "command": "python3",
      "args": ["/path/to/mesh-memory/mcp_server.py"],
      "env": {
        "MESH_API_URL": "http://localhost:8000"
      }
    }
  }
}

When the server is reachable, the 13 tools listed below become available.

MCP Tools

Tool	Purpose
mesh_focus	Switch the active workspace (optionally prefetch recent docs).
mesh_add	Save a document with optional tags. Auto-adds date:YYYY-MM-DD and source:.
mesh_update	Update content, tags, or pinned status of an existing document.
mesh_delete	Delete a document by GUID.
mesh_get	Fetch a single document by GUID.
mesh_search	Semantic search by query, optionally across multiple workspaces with weights.
mesh_bytag	List documents that match one or more tags (AND logic).
mesh_recent	List most recently created documents, optionally filtered by type: tag.
mesh_projects	List per-project document counts (uses guid: tag as project marker).
mesh_tags	List existing tags with counts; optional prefix filter.
mesh_versions	Show the version chain of a document (similarity-linked revisions).
mesh_stats	Memory statistics for the active workspace.
mesh_schema	Show the tag schema (recognized prefixes and types).