mementonotes-mcp

MCP (Model Context Protocol) server for the Memento Notes app. Proxies deck/card CRUD, FSRS-5 spaced repetition review, and study statistics to the macOS app via Unix Domain Socket.

Architecture

Claude Desktop/Code ──stdio──> mementonotes-mcp ──UDS──> Memento Notes.app (GRDB in-process)

The macOS app hosts a JSON-RPC 2.0 server on a Unix Domain Socket. This MCP server is a thin proxy: it receives tool calls via stdio and forwards them to the app. All database operations happen in the app process, eliminating concurrent-writer issues.

Requirement: The Memento Notes macOS app must be running for the MCP server to work.

Install

npm install -g mementonotes-mcp

Or run directly with npx:

npx mementonotes-mcp

Setup

Claude Code

claude mcp add mementonotes-mcp -- npx mementonotes-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "mementonotes-mcp": {
      "command": "npx",
      "args": ["mementonotes-mcp"]
    }
  }
}

Socket Path

By default, the MCP server connects to the app's socket at:

• macOS: ~/Library/Application Support/MementoNotes/mcp.sock

Override with the MEMENTONOTES_SOCKET_PATH environment variable:

MEMENTONOTES_SOCKET_PATH=/path/to/mcp.sock npx mementonotes-mcp

Available Tools

| Tool | Description | |------|-------------| | list_decks | List all flashcard decks | | get_deck | Get a single deck by ID | | create_deck | Create a new deck | | delete_deck | Delete a deck and all its cards | | list_cards | List all cards in a deck | | get_card | Get a single card by ID | | create_card | Create a new flashcard | | update_card | Update card content | | delete_card | Delete a card | | bulk_create_cards | Create multiple cards at once | | get_due_cards | Get cards due for review | | review_card | Submit a review rating (FSRS-5) | | get_deck_stats | Deck statistics (due/new/young/mature) | | get_study_history | Daily review history with grade breakdown | | search_cards | Search cards by text |

FSRS-5 Rating Scale

| Rating | Label | Effect | |--------|-------|--------| | 1 | Again | Card forgotten, re-learn | | 2 | Hard | Recalled with difficulty | | 3 | Good | Standard recall | | 4 | Easy | Effortless recall |

Development

cd flashcard-mcp
npm install
npm run build
npm start