# memoryOSS

Persistent long-term memory for AI agents. Local proxy + MCP memory layer for Claude, Codex, and OpenAI-compatible clients.

## Quick Start

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

# Browse available tools
npx -y @smithery/cli@latest tool list memoryosscom/memoryoss

# Get full schema for a tool
npx -y @smithery/cli@latest tool get memoryosscom/memoryoss memoryoss_recall

# Call a tool
npx -y @smithery/cli@latest tool call memoryosscom/memoryoss memoryoss_recall '{}'
```

## Direct MCP Connection

Endpoint: `https://memoryoss--memoryosscom.run.tools`

**Required config:**
- `memoryoss-api-key` (header) — Your memoryOSS API key. Smithery forwards it to the public bridge using the memoryoss-api-key header.

## Tools (4)

- `memoryoss_recall` — Search your long-term memory. Call this FIRST at the start of every conversation turn to retrieve relevant context from…
- `memoryoss_store` — Save important information to long-term memory so you can recall it in future sessions. Store facts, decisions, user pr…
- `memoryoss_update` — Update an existing memory by ID. Use this when information has changed - e.g. a user preference was corrected or a fact…
- `memoryoss_forget` — Delete memories by their IDs. Use when the user asks you to forget something or when stored information is wrong and sh…

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

---

License: AGPL-3.0