Mementos

Universal memory system for AI agents - CLI + MCP server + library API

npm License

Install

npm install -g @hasna/mementos

CLI Usage

mementos --help

MCP Server

mementos-mcp

116 tools available.

HTTP mode

Run a shared Streamable HTTP MCP server (stateless, 127.0.0.1 only):

mementos-mcp --http
# or: MCP_HTTP=1 mementos-mcp
# default port: 8824 (override with --port or MCP_HTTP_PORT)

Endpoints: GET /health, POST /mcp (Streamable HTTP).

REST API

mementos-serve

Cloud Sync

This package supports cloud sync via @hasna/cloud:

cloud setup
cloud sync push --service mementos
cloud sync pull --service mementos

Data Directory

Data is stored in ~/.hasna/mementos/.

License

Apache-2.0 -- see LICENSE