Memo

memo-mcp is an MCP server that lets you record, search, and retrieve memos using a lightweight local JSON database (LowDB). It stores memo contents locally and provides a straightforward set of memo and category management tools, making it ideal for personal note-taking without external dependencies.

How to use

You interact with memo-mcp through your MCP client. Once the server is configured, you can create new memos, fetch all memos, retrieve a memo by its ID, update or delete memos, and search memos by keyword. You can also manage categories by creating, listing, retrieving, updating, and deleting them. The local data is stored in a JSON file, so you can back up or move your memos by copying that file.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

Create a configuration snippet for your MCP client that points to memo-mcp. The server is configured as a stdio MCP that runs via npx memo-mcp with an optional DB_PATH environment variable to specify the local JSON file.

Add the following JSON block to your MCP client configuration. This example shows the memo-mcp server with a local JSON database path placeholder.

{
  "mcpServers": {
    "memo-mcp": {
      "command": "npx",
      "args": ["-y", "memo-mcp"],
      "env": {
        "DB_PATH": "path/to/json_file.json"
      }
    }
  }
}

Additional configuration and notes

DB_PATH is optional. If you omit it, memo-mcp will default to using a local file named memo.json in the working directory. You can customize the file location by setting DB_PATH to your preferred path.

If you want to run memo-mcp via your MCP client, paste the exact configuration snippet above into your client’s MCP setup. The client will handle starting the server process according to the specified command and arguments.

Available tools

createMemo

Create a new memo with content and optional metadata such as category or tags.

getMemos

Retrieve all memos stored in the local database.

getMemo

Retrieve a memo by its unique ID.

updateMemo

Update the content or metadata of a memo by its ID.

deleteMemo

Delete a memo by its ID.

searchMemos

Search memos by keyword across content and metadata.

createCategory

Create a new memo category.

getCategories

Retrieve all memo categories.

getCategory

Retrieve a category by its ID.

updateCategory

Update a category by its ID.

deleteCategory

Delete a category by its ID.