Skip to main content
Glama
memo-mcp
by 108yen

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: heropen

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"]
    }
  }
}

Available Tools

11 tools
createCategoryCreate CategoryC

Create a new category

Inputs: name (required). Returns: category

createMemoCreate MemoC

Create a new memo

Inputs: content (required), title (required), categoryId. Returns: memo

deleteCategoryDelete CategoryC

Delete a category

Inputs: id (required). Returns: category

deleteMemoDelete MemoB

Delete a memo

Inputs: id (required). Returns: memo

getCategoriesGet CategoriesA

Get all categories

Inputs: no named parameters. Returns: categories

getCategoryGet CategoryA

Get a single category by ID

Inputs: id (required). Returns: category

getMemoGet MemoA

Get a single memo by ID

Inputs: id (required). Returns: memo

getMemosGet MemosC

Get all memos

Inputs: no named parameters. Returns: memos

searchMemosSearch MemosB

Search memos by keyword and date range

Inputs: categoryId, end, query, start. Returns: memos

updateCategoryUpdate CategoryD

Update a category

Inputs: id (required), name. Returns: category

updateMemoUpdate MemoC

Update a memo

Inputs: id (required), categoryId, content, title. Returns: memo

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct resource (category or memo) and action (create, read, update, delete, search), with no overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb+noun pattern using camelCase (e.g., createCategory, getMemos, deleteCategory), making them predictable.

    Tool Count5/5

    11 tools provide full CRUD for two resources plus search, which is well-scoped for a memo management server without excess.

    Completeness5/5

    Covers complete lifecycle for categories and memos (create, read, update, delete) plus search, with no obvious missing operations.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides persistent long-term memory for AI agents via local SQLite storage with low token overhead, enabling memory storage, retrieval, and management across sessions.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      A local memory server for AI agents that stores and retrieves information via MCP, keeping all data in SQLite on your machine.
      153 PyPI
      1
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that gives agents persistent memory with namespaced facts, tags, full-text search, and TTL expiry, all running locally on SQLite with zero external dependencies.
      8
      3
      MIT