A local notes management system using the Model Context Protocol (MCP). This system allows you to create, read, search, and manage notes in a local directory, similar to Obsidian or Notion.
- Create and manage notes in Markdown format
- Automatic metadata management (creation date, modification date)
- Tag-based organization
- Full-text search
- Local storage (no cloud dependencies)
- Clone this repository
- Install dependencies:
npm install
- Build the project:
npm run build
The notes will be stored in the notes directory in your project root.
The MCP provides the following commands:
notes.list();Returns a list of all notes with their metadata.
notes.read({ id: string });Reads a specific note by its ID.
notes.write({
id: string,
title: string,
content: string,
tags?: string[]
})Creates or updates a note with the specified content and metadata.
notes.search({
query: string,
tags?: string[]
})Searches notes by content and/or tags.
Notes are stored in Markdown format with YAML front matter for metadata:
---
title: Note Title
tags: [tag1, tag2]
created: 2024-03-21T12:00:00.000Z
modified: 2024-03-21T12:00:00.000Z
---
Note content goes here...ISC