Skip to main content
Glama
MCP-Vault

MCP-Vault

by manalmanzoor

Vault — a tiny personal MCP server

Notes + bookmarks, stored in a single SQLite file, exposed to Claude through 5 tools: add_note, add_bookmark, search_notes, list_notes, delete_note.

1. Install uv (one-time)

Open PowerShell and run:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Close and reopen your terminal after this so uv is on PATH.

Related MCP server: MCP Notes Server

2. Set up the project

Unzip this folder somewhere permanent, e.g. C:\Users\<you>\mcp-vault. Then from inside it:

cd C:\Users\<you>\mcp-vault
uv sync

This creates a virtual environment and installs fastmcp.

3. Test it standalone (before touching Claude Desktop)

uv run fastmcp dev server.py

This opens the MCP Inspector in your browser. Click into the Tools tab, try calling add_note with some text, then list_notes — you should see it come back. Ctrl+C to stop it once you're happy.

4. Wire it into Claude Desktop

Open (or create) this file:

%APPDATA%\Claude\claude_desktop_config.json

Add a vault entry under mcpServers. If the file already has other servers in it, just add this key alongside them — don't replace the whole file.

{
  "mcpServers": {
    "vault": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\<you>\\mcp-vault",
        "fastmcp",
        "run",
        "server.py"
      ]
    }
  }
}

Replace C:\\Users\\<you>\\mcp-vault with wherever you actually put the folder — use double backslashes as shown.

5. Restart Claude Desktop

Fully quit it (right-click the tray icon → Quit, not just closing the window) and reopen. Look for the tools icon in the chat box — click it and you should see the 5 vault tools listed.

6. Try it

  • "Save a note: renew passport, tag it todo"

  • "Save this link: https://example.com, title it Example, tag it reference"

  • "What have I saved tagged todo?"

  • "Search my notes for passport"

  • "Delete note 1"

Your data lives in vault.db right next to server.py — it's just a SQLite file, so you can open it with any SQLite browser if you want to poke at it directly.

Screenshots

Notes

  • Every tool's docstring is what Claude reads to decide when to call it — if you rename or repurpose a tool, keep the docstring accurate, that's the whole interface.

  • If Claude Desktop doesn't pick up the server, check %APPDATA%\Claude\logs\ for errors — usually it's a wrong path in the config.

👩‍💻 Author

Manal Manzoor Software Engineering Student COMSATS University Islamabad, Wah Campus

GitHub: @manalmanzoor

Available Tools

5 tools
add_bookmarkB

Save a link/bookmark to the vault.

title is required; note is an optional comment on why it's worth keeping.

Inputs: url (required), title (required), note, tags. Returns: result

add_noteB

Save a quick note or thought to the vault.

Use tags to make it easy to find later, e.g. ["work", "idea", "todo"].

Inputs: content (required), tags. Returns: result

delete_noteC

Delete a note or bookmark by its id number.

Inputs: item_id (required). Returns: result

list_notesA

List recent notes and bookmarks, optionally filtered by a single tag.

Inputs: tag, limit. Returns: result

search_notesB

Search notes and bookmarks by matching text in the content or tags. Use this when user wants to recall something, Prefer this over guessing.

Inputs: query (required). Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a distinct purpose: adding notes vs bookmarks, searching across both, listing by tag, and deleting by ID. No two tools overlap in function, so an agent can easily select the correct one.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with lowercase and underscores: add_note, add_bookmark, search_notes, list_notes, delete_note. The pattern is uniform and predictable.

    Tool Count5/5

    Five tools cover the essential operations for a note/bookmark vault (add two types, search, list, delete). The scope is well-defined and each tool serves a necessary role without bloat.

    Completeness4/5

    Core operations are covered: create (notes and bookmarks), read (search and list), delete. The only notable gap is the lack of an update/edit tool, but users can work around by deleting and recreating. This is a minor omission.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A beginner-friendly MCP server for managing personal notes. Enables Claude to create, list, read, search, update, and delete notes saved as Markdown files.
      6
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that gives Claude a persistent personal notebook. Notes are stored on disk as JSON, so they survive restarts and are shared across every tool and resource.
      -
    • A
      license
      A
      quality
      D
      maintenance
      A personal notes MCP server that allows AI assistants to create, search, edit, and manage notes stored in a local SQLite database.
      6
      MIT