memopaper-mcp

MCP server for memopaper — gives AI agents direct access to your memo buffer.

Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "memopaper": {
      "command": "npx",
      "args": ["memopaper-mcp@latest"],
      "env": {
        "MEMOPAPER_API_KEY": "mp_..."
      }
    }
  }
}

Claude Code

Add .mcp.json to your project root:

{
  "mcpServers": {
    "memopaper": {
      "command": "npx",
      "args": ["memopaper-mcp@latest"],
      "env": {
        "MEMOPAPER_API_KEY": "mp_..."
      }
    }
  }
}

Get your API key at memopaper.dev under Dashboard → API Keys.

Note: Never commit .mcp.json containing your API key to version control. Add it to .gitignore.

Tool

Exposes a single memo tool with the following actions:

| Action | Description | Required params | |--------|-------------|-----------------| | add | Save a memo | text | | list | List memos | — | | get | Get a memo by UUID | uuid | | get_nth | Get the Nth latest memo (1=newest) | index | | latest | Get the latest memo | — | | oldest | Get the oldest memo | — | | pop | Get and delete the latest memo | — | | delete | Delete a memo by UUID | uuid | | edit | Edit a memo's text | uuid, text | | stats | Show total count and per-group breakdown | — |

Optional params on most actions: group, visibility, limit.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | MEMOPAPER_API_KEY | Yes | API key from the dashboard, starting with mp_ |

Claude Code Skills

For Claude Code users, optional slash commands are available in the skills/ directory:

| Skill | Description | |-------|-------------| | skills/watch.md | /memopaper:watch — watch a group and execute memos sequentially | | skills/help.md | /memopaper:help — show usage help |

Install:

mkdir -p ~/.claude/commands/memopaper
cp skills/watch.md ~/.claude/commands/memopaper/watch.md
cp skills/help.md  ~/.claude/commands/memopaper/help.md

Usage:

/memopaper:watch @tasks
/memopaper:watch @tasks 10
/memopaper:watch @tasks --shell

Warning: All memo execution — whether as AI instructions or shell commands — runs on your machine with your permissions. You are fully responsible for the content and consequences of every memo in the queue. Use only with memo groups you fully control and trust.

Shell execution is disabled by default. Pass --shell to enable it. Even then, destructive commands (rm, del, git reset --hard, dd, etc.) are automatically blocked and logged to @warning.

Related

• memopaper.dev — web dashboard
• memopaper — CLI client