MCP Notes Server

A Model Context Protocol (MCP) server for developer note-taking. Track your project implementation progress with easy-to-use tools for creating, managing, and exporting development notes.

Features

• Add Notes: Create notes for features you're implementing with tags, status, and priority

• List Notes: View and filter notes by feature, tags, or status

• Update Notes: Modify existing notes as your implementation progresses

• Delete Notes: Remove notes that are no longer needed

• Export Notes: Export your notes to Markdown or JSON format

• Persistent Storage: Notes are saved locally in JSON format

Related MCP server: MCP Notes Server

Installation

pip install mcp-notes-server

Usage

Running the Server

mcp-notes-server

Available Tools

1. add_note: Add a new development note

   • feature (required): The feature being implemented

   • content (required): The note content

   • tags (optional): Array of tags for categorization

   • status (optional): "in_progress", "completed", or "blocked"

   • priority (optional): "low", "medium", or "high"

2. list_notes: List notes with optional filtering

   • feature (optional): Filter by feature name (partial match)

   • tags (optional): Filter by tags

   • status (optional): Filter by status

3. update_note: Update an existing note

   • note_id (required): The ID of the note to update

   • content (optional): New content

   • status (optional): New status

   • priority (optional): New priority

   • tags (optional): New tags

4. delete_note: Delete a note

   • note_id (required): The ID of the note to delete

5. export_notes: Export notes to markdown or JSON format

   • feature (optional): Filter by feature before export

   • format (optional): "markdown" or "json" (default: "markdown")

Integration with Claude Desktop

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "notes": {
      "command": "mcp-notes-server"
    }
  }
}

Storage

Notes are stored in ~/.mcp_notes/notes.json by default.

Development

To install in development mode:

git clone https://github.com/yourusername/mcp-notes-server.git
cd mcp-notes-server
pip install -e .

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.