# MemoryMesh

The SQLite of AI Memory — persistent, zero-dependency memory for any LLM application. Dual-store architecture (project + global), pluggable embeddings (local/Ollama/OpenAI), semantic search with time…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add sparkvibe-io/memorymesh

# Browse available tools
npx -y @smithery/cli@latest tool list sparkvibe-io/memorymesh

# Get full schema for a tool
npx -y @smithery/cli@latest tool get sparkvibe-io/memorymesh remember

# Call a tool
npx -y @smithery/cli@latest tool call sparkvibe-io/memorymesh remember '{}'
```

## Direct MCP Connection

Endpoint: `https://memorymesh--sparkvibe-io.run.tools`

**Optional config:**
- `projectPath` (query) — Path to the project root for project-scoped memories.
- `globalPath` (query) — Path to the global memory database.
- `embedding` (query) — Embedding provider to use. Default: none.

## Tools (10)

- `remember` — Store a new memory in MemoryMesh. Use this to save facts, preferences, decisions, or any information that should persis…
- `recall` — Recall relevant memories from MemoryMesh using semantic similarity and keyword matching.
- `forget` — Permanently delete a specific memory by its ID. Searches both project and global stores.
- `forget_all` — Forget ALL stored memories in the specified scope. This is a destructive operation. Defaults to project scope.
- `update_memory` — Update an existing memory's text, importance, scope, or metadata in place. Only provided fields are changed.
- `memory_stats` — Get statistics about stored memories: total count, oldest and newest timestamps.
- `session_start` — Retrieve structured context for the start of a new AI session. Returns user profile, guardrails, common mistakes, and p…
- `review_memories` — Audit memories for quality issues (scope mismatches, verbosity, staleness, duplicates). Returns issues with suggestions.
- `status` — Get MemoryMesh health status: project store, global store, embedding provider, and version.
- `configure_project` — Set the project root at runtime without restarting the server. Creates the project database at <path>/.memorymesh/memor…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get sparkvibe-io/memorymesh <tool-name>
```

## Prompts (1)

- `memory-context` — Get formatted memory context for the current session.