Skip to main content
Glama
fabianharmikstelzer

local-memo

by fabianharmikstelzer
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

local-memo

Local-only MCP server for saving and restoring conversation context across AI agent sessions. No cloud, no accounts — just JSON files on disk.

Inspired by Upstash Memo, but fully local.

Why?

Memo is a great idea — save your conversation context, get a short ID, restore it later in a different session or agent. But there's no reason that data needs to leave your machine. This version replaces the cloud API + Redis with plain files in ~/.local-memo/.

Related MCP server: mcp-server

Install

Claude Code

claude mcp add local-memo -- npx local-memo

Or from a local clone:

claude mcp add local-memo -- node /path/to/local-memo/dist/index.js

Claude Desktop / Cursor

Add to your MCP config:

{
  "mcpServers": {
    "local-memo": {
      "command": "npx",
      "args": ["local-memo"]
    }
  }
}

Usage

Save context

Ask your AI agent to save the current conversation context. It will call memo_set and return a short ID:

> Please save our conversation context

Context saved locally.
ID: 4tJ630XqhCV5gQelx98pu
Expires: 2025-01-30T14:38:51.278Z (1440 minutes)

Restore context

In a new session, give the agent the ID:

> Restore memo 4tJ630XqhCV5gQelx98pu

List saved memos

> List my saved memos

Delete a memo

> Delete memo 4tJ630XqhCV5gQelx98pu

Tools

Tool

Description

memo_set

Save structured context (goal, completed tasks, pending tasks, decisions, files, extra context). Returns an ID.

memo_get

Restore context by ID. Returns formatted markdown.

memo_list

List all unexpired memos with their IDs and goals.

memo_delete

Delete a memo by ID.

Options

Flag

Default

Description

--ttl-mins

1440 (24h)

How long memos live before expiring

--dir

~/.local-memo

Storage directory

Example with 7-day TTL:

claude mcp add local-memo -- npx local-memo --ttl-mins 10080

Storage

Memos are plain JSON files in ~/.local-memo/memos/:

{
  "id": "4tJ630XqhCV5gQelx98pu",
  "createdAt": "2025-01-29T14:38:51.278Z",
  "expiresAt": "2025-01-30T14:38:51.278Z",
  "ttlMins": 1440,
  "context": {
    "goal": "Build a local memo system",
    "completed": ["Designed schema", "Wrote MCP server"],
    "pending": ["Test it"],
    "decisions": ["Use filesystem instead of Redis"],
    "files": ["index.ts", "package.json"],
    "context": "Extra notes here"
  }
}

Back them up, sync them, grep them — they're just files.

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/fabianharmikstelzer/local-memo'

If you have feedback or need assistance with the MCP directory API, please join our Discord server