NotePlan adds support for an MCP server for AI agents (like Claude Desktop, Claude Code, OpenAI Codex, and more), alongside new Space management tools, much faster note opening and embedded table loading, and important stability fixes across the app.


Local MCP Server

On macOS, you can now connect NotePlan to your favorite AI agent by installing the local MCP server (see here how to install it).

The AI can assist with common tasks such as managing tasks, reading notes, creating summaries, and searching for content. In addition, it can create plugins, themes, and templates—and even run and debug them for you. This makes it easy to build custom plugins perfectly tailored to your needs.

The MCP server runs entirely locally and does not send any data to external servers. Only the notes the AI agent interacts with are shared with the AI providers (such as Anthropic’s Claude or OpenAI’s Codex).

We’ve published the server online, so you can install it by adding it to your AI tool’s MCP configuration. Open Claude or Codex → Settings → Developer → Add the MCP server.

With Claude, you currently need to edit a configuration file and add the following:

{
  "mcpServers": {
    "noteplan": {
      "command": "npx",
      "args": ["-y", "@noteplanco/noteplan-mcp"]
    }
  }
}

Why use an MCP server instead of pointing Claude Code or Codex directly at NotePlan’s files? The MCP server guides the AI and exposes tools tailored to NotePlan for searching, reading, and interpreting notes, including their Markdown and Properties, and for editing them with precision. This reduces token usage and helps minimize AI errors.

It’s also safer: the MCP tools don’t allow the AI to permanently delete notes (only move them to the trash), and changes must first be performed as a dry run before being applied. This makes the AI much more cautious when modifying your notes.

Guides:

• Installation and Troubleshooting Guide
• Privacy

MCP Tools:

• Notes and task searching/reading/writing
• Calendar events and Reminders reading/writing (NotePlan needs to run for this)
• Access to Spaces
• Build, debug, install and run plugins (it can write plugin code, run it, read errors, create screenshots to verify the results and make improvements)
• Create and set themes
• Create, run and debug templates (it has a built-in documentation and can run templates, reading out the errors and correcting them)
• Control NotePlan: Open notes and views

Compatible AI Agents:

• Claude Desktop, Claude Code, Claude Cowork, OpenAI Codex (use it with your ChatGPT subscription)
• Other AI tools that run on your Mac and allow access to local MCP tools

Spaces Tools

We’ve added new tools to help you manage your Spaces. You can now export and import all your notes directly from the Mac and iOS apps as Markdown files. This includes not only regular notes, but also calendar notes (supported for both import and export).

You can now also show or hide calendar notes in Spaces. Some Spaces may not need calendar notes and they can become unnecessary noise. To change this, right-click a Space (or long-press on iOS), select “Calendar Notes,” and choose which calendar notes you want to see.

In addition, Spaces are now backed up by default along with your private notes. Three rolling daily backups are created automatically.

Performance Improvements

Notes now open much faster. Large notes—especially those containing tables or code blocks—previously slowed down loading. We’ve improved this significantly, making note opening much smoother on both Mac and iOS.

Fixes & Improvements

• Added: Drag-and-drop markdown files from Finder into sidebar
• Added: "Bottom" option in drag-drop into a daily note menu
• Added: New AppleScript commands (calendar, reminders, notes CRUD, and more)
• Added: Drag in the the timeline to create an event (drag to define start and end time)
• Improved: Shift+Return for newlines in AI prompt popover
• Improved: Smooth references section height animation
• Fixed: Version history preserved when renaming files
• Fixed text formatting around inline code
• Fixed filter UI alignment
• Fixed table column crash
• Fixed several stability crashes
• Fixed publishing notes with bullets and tasks following the settings
• Fixed first startup didn't start logging
• Fixed indentations in numbered list editing
• Fixed: 7-day view showing fixed week events instead of selected date range
• Fixed: Double-click to zoom/minimize in title bar
• Fixed: Command bar not accepting CMD+Enter to open a note in a new window
• Fixed: Empty heading in references for notes where the title was defined in the frontmatter only
• Fixed: MCP-created space notes not appearing in sidebar

---

Enjoying NotePlan? A quick review on the App Store helps support independent development.