noteplan-mcp

mnedoszytko/noteplan-mcp

3.3

If you are the rightful owner of noteplan-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The NotePlan MCP Server allows interaction with NotePlan notes through Claude or other LLMs, providing a seamless integration for note-taking and task management.

The NotePlan MCP Server is designed to facilitate interaction with NotePlan, a markdown-based note-taking and task management application available on macOS and iOS. NotePlan combines calendar, notes, and todos in one place, making it a versatile tool for organizing tasks and projects. The MCP server enables users to access and manipulate their notes and tasks programmatically, leveraging the capabilities of Claude or other language models. This integration allows for automated note management, task extraction, and project browsing, enhancing productivity and organization. The server is easy to set up and configure, with support for custom data directories and integration with Claude Desktop and Claude Code. Users can perform a variety of actions such as reading notes, searching for specific content, listing tasks, and managing projects, all through a simple and intuitive interface.

Features

  • Read daily notes: Access today's note or any specific date.
  • Search notes: Find notes containing specific text.
  • List tasks: Extract todos from your notes with completion status.
  • Browse projects: List all project folders and their contents.
  • Query specific notes: Read any note by its path.

Usages

usage with Claude Desktop

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

usage with Claude Code

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

Tools

  1. read_today_note

    Reads today's daily note from NotePlan.

  2. read_date_note

    Reads a daily note for a specific date.

  3. read_note

    Reads a specific note by its path.

  4. search_notes

    Searches for notes containing specific text.

  5. list_tasks

    Lists all tasks from notes.

  6. list_projects

    Lists all project folders and their note counts.

  7. add_task

    Adds a task to a note.

  8. append_to_note

    Appends content to a note.

  9. toggle_task

    Toggles a task between done and undone.

  10. edit_task

    Edits an existing task's text while preserving its status.