memo-mcp

NPM Version codecov MIT License

memo-mcp is an MCP (Model Context Protocol) server that enables agents to record, search, and retrieve memos using LowDB as a lightweight local database.

This server stores memo contents in a local JSON file and provides comprehensive memo management functionality including creation, updates, search, and retrieval operations. All data is persisted locally using LowDB, making it ideal for personal memo management without requiring external database dependencies.

Features

The main tools provided by memo-mcp are as follows:

Tool Name	Description
createMemo	Create a new memo
getMemos	Retrieve all memos
getMemo	Retrieve a memo by specified ID
updateMemo	Update a memo by specified ID
deleteMemo	Delete a memo by specified ID
searchMemos	Search memos by keyword
createCategory	Create a new category
getCategories	Retrieve all categories
getCategory	Retrieve a category by ID
updateCategory	Update a category by ID
deleteCategory	Delete a category by ID

Related MCP server: mcp-memory-libsql

Usage

DB_PATH is optional. (default: memo.json)

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

VS Code Installation Instructions

For quick installation, use one of the one-click installation buttons below:

Install with NPX in VS Code

For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open Settings (JSON).

Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.

{ "servers": { "canary": { "command": "npx", "args": ["-y", "memo-mcp"] } } }