MCP Note Manager

A Model Context Protocol (MCP) server for managing notes. This server provides tools to create, read, update, delete, list, and search notes directly from Claude Desktop.

Features

• Full CRUD operations: Create, read, update, and delete notes
• Search functionality: Search notes by title or content
• Metadata tracking: Automatically tracks creation and modification timestamps
• Resource exposure: Notes are exposed as MCP resources for easy access
• JSON storage: Notes are stored as JSON files with metadata

Installation

1. Clone this repository
2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Configuration for Claude Desktop

Add the following to your Claude Desktop MCP settings:

{
  "mcpServers": {
    "mcp-note-manager": {
      "command": "node",
      "args": ["/path/to/mcp-note-manager/dist/index.js"]
    }
  }
}

Replace /path/to/mcp-note-manager with the actual path to this project.

Available Tools

create_note

Create a new note with a title and content.

• Parameters:
  • title (string): Title of the note
  • content (string): Content of the note

read_note

Read the content of a specific note.

• Parameters:
  • title (string): Title of the note to read

update_note

Update an existing note's content.

• Parameters:
  • title (string): Title of the note to update
  • content (string): New content for the note

delete_note

Delete a note.

• Parameters:
  • title (string): Title of the note to delete

list_notes

List all available notes with their metadata (creation and modification dates).

search_notes

Search notes by content or title.

• Parameters:
  • query (string): Search query to find in note contents or titles

Development

For development with auto-reload:

npm run dev

Note Storage

Notes are stored in the notes/ directory as JSON files. Each note contains:

• Content: The actual note text
• Metadata: Title, creation timestamp, and last modification timestamp

The filenames are sanitized versions of the note titles to ensure filesystem compatibility.