MCP Notes Server
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 Notes Server add a note to buy groceries"
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.
MCP Notes Server
A small Model Context Protocol (MCP) server that gives an AI a personal notes / todo store. Built for learning.
What is MCP?
MCP is an open standard that lets an AI model call functions in your code.
You expose tools (functions with a name, description, and typed inputs);
the AI reads the descriptions and decides when to call them. Communication
here happens over stdio — the AI client launches notes-server.js and exchanges
JSON messages over stdin/stdout.
Related MCP server: MCP Personal Tools Server
Tools in this server
Tool | What it does |
| Add a new note/todo |
| List notes (filter: all / open / done) |
| Search notes by keyword |
| Mark a note done by id |
| Delete a note by id |
Notes are saved to notes.json next to the server, so they survive restarts.
Run it
npm install
npm start # prints "notes-server running on stdio" then waitsIt looks like it "hangs" — that's correct. It's waiting for an AI client to talk to it over stdin. Press Ctrl+C to stop.
Connect it to Claude Code (CLI)
claude mcp add notes -- node /home/tw/Documents/mcp/notes-server.jsThen in a Claude Code session, try: "Add a note to buy milk", then "list my open notes".
Available Tools
5 toolsadd_noteAdd a noteA
Add a new note or todo item to the store. Use this whenever the user wants to remember something, jot down a task, or create a todo.
Inputs: text (required).
complete_noteComplete a noteA
Mark a note/todo as done, by its id.
Inputs: id (required).
delete_noteDelete a noteA
Permanently delete a note/todo by its id.
Inputs: id (required).
list_notesList notesA
List all saved notes/todos. Optionally filter to only show items that are still open (not done) or only completed ones.
Inputs: filter.
search_notesSearch notesA
Search notes by a keyword. Returns any note whose text contains the query (case-insensitive).
Inputs: query (required).
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 clear, distinct purpose (add, list, search, complete, delete) with no overlapping functionality. An agent can easily distinguish them.
All tools follow a consistent verb_noun pattern (e.g., add_note, delete_note) with no deviations, making the naming predictable.
5 tools is well-suited for a notes server, covering essential operations without being overly sparse or bloated.
The set covers basic CRUD operations but lacks an update tool for editing note content, which is a notable gap. Users must delete and re-add to modify text.
Maintenance
Related MCP Connectors
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Remote MCP server for notes, tasks, kanban boards and docs - the Slates agentic workspace
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list through Claude.209MIT
- AlicenseBqualityDmaintenanceA simple server implementing the Model Context Protocol (MCP) that exposes personal tools like note-taking for compatible MCP clients or agents.2ISC
- AlicenseBqualityDmaintenanceA simple server for saving, listing, and searching notes persisted to a local JSON file. It enables users to manage their personal notes using natural language via the Model Context Protocol.3ISC
- 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.-