MCP-Vault
This server is a tiny personal MCP vault for storing and retrieving notes and bookmarks in a SQLite database.
add_note: Save a quick note or thought, optionally with tags (e.g., work, todo).
add_bookmark: Save a link/bookmark with a required URL and title, plus optional note and tags.
search_notes: Search saved notes and bookmarks by matching text in content or tags.
list_notes: List recent notes and bookmarks, optionally filtered by a single tag, with a configurable limit.
delete_note: Delete a note or bookmark by its numeric id.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP-Vault save a note: buy groceries, tag it personal"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 syncThis creates a virtual environment and installs fastmcp.
3. Test it standalone (before touching Claude Desktop)
uv run fastmcp dev server.pyThis 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.jsonAdd 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 toolsadd_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
Scored across 5 tools
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.
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.
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.
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
Related MCP Connectors
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
MCP-native notes and memory for ChatGPT, Claude, and other AI tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA zero-dependency MCP server that provides a persistent personal knowledge base for Claude using local JSON file storage. It enables users to manage notes through tools for adding, searching, and indexing content built entirely with Node.js built-ins.1ISC
- AlicenseAqualityDmaintenanceA beginner-friendly MCP server for managing personal notes. Enables Claude to create, list, read, search, update, and delete notes saved as Markdown files.6MIT
- FlicenseNot gradedqualityDmaintenanceA 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.-
- AlicenseAqualityDmaintenanceA personal notes MCP server that allows AI assistants to create, search, edit, and manage notes stored in a local SQLite database.6MIT