📚 MCP Notes

What is 📚 MCP Notes?

📚 MCP Notes is a personal knowledge management system built on the Model Context Protocol (MCP) that transforms daily notes into organized, searchable knowledge. It helps users capture thoughts quickly, organize them automatically, and retrieve them easily.

How to use 📚 MCP Notes?

Clone the repository, run npm i and npm run build, then add a configuration entry to your Claude Desktop JSON to point to the compiled server and a notes directory. Once configured, invoke tools like /log, /rollup, write_note, sticky, or evaluateInsight through any MCP‑compatible client to capture, categorize, and retrieve notes.

Key features of 📚 MCP Notes

• Daily logs as atomic capture units
• Automatic rollups that synthesize daily notes into summaries
• Four knowledge categories: Accomplishment, Insight, TODO, Knowledge
• Tools for logging, rolling up, searching, and evaluating notes
• AI assistance for categorization, connection, and pattern identification
• Plain text Markdown storage for future-proof portability

Use cases of 📚 MCP Notes

• Log daily accomplishments and insights from coding sessions
• Automatically generate weekly summaries of work and thinking
• Capture lessons learned after fixing bugs or completing features
• Search through past notes to retrieve technical context or decisions
• Evaluate the long‑term value of ideas before acting on them

FAQ from 📚 MCP Notes

What file format does 📚 MCP Notes use?

All notes are stored as plain text Markdown files, ensuring future‑proof portability, version control compatibility, and easy editing with any text editor.

How are notes organized?

Notes start as daily logs (one Markdown file per day). Rollups automatically condense daily logs into higher‑level summaries, and all notes are classified into four categories: Accomplishment, Insight, TODO, and Knowledge.

What tools does 📚 MCP Notes provide?

Core tools include /log (create/update daily log), /rollup (synthesize daily notes), write_note, sticky (evaluate thought stickiness), and evaluateInsight. File system tools include search_files, read_note, read_multiple_notes, list_directory, and create_directory.

Does 📚 MCP Notes require a specific MCP client?

It is tool‑agnostic and works with any MCP‑compatible client, such as Claude Desktop, Copilot, or Cursor. A manual setup with the Claude Desktop configuration is provided as an example.

What are the runtime dependencies of 📚 MCP Notes?

Node.js and npm are required to build the server from source. The notes directory path is provided as a command‑line argument when starting the server.