home / mcp / noteplan mcp server

NotePlan MCP Server

Unofficial Noteplan.co MCP server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bscott-noteplan-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/noteplan-mcp/build/index.js"
      ],
      "env": {
        "MCP_LOG_LEVEL": "INFO",
        "NOTEPLAN_DATA_DIR": "YOUR_NOTEPLAN_DIR"
      }
    }
  }
}

This MCP server lets Claude Desktop talk to your NotePlan notes. You can read notes, search across your collection, create new notes, manage daily notes, and update existing content directly from Claude conversations, making note-taking and planning seamless.

How to use

You interact with NotePlan through an MCP client in Claude Desktop. Start the server locally, then connect Claude to it so you can issue natural-language requests that perform actions like reading notes, searching content, creating new notes, and updating existing ones. When you ask for notes in a specific folder or for a particular date, the MCP server routes your request to the NotePlan data and returns results you can act on in your chat.

How to install

Prerequisites: Node.js and npm must be installed on your machine.

Clone the project, install dependencies, and build the server.

Step by step installation commands

git clone https://github.com/bscott/noteplan-mcp.git
cd noteplan-mcp
npm install
npm run build
```} ,{

Start the MCP server for use with Claude Desktop.

Claude Desktop configuration

Configure Claude Desktop to launch the MCP server. Use the following settings to point Claude at your local MCP server instance.

Claude Desktop setup example

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

Replace /absolute/path/to/noteplan-mcp with the actual directory where you cloned the project. After saving, restart Claude Desktop to apply the changes.

Troubleshooting tips

If Claude Desktop cannot connect, verify that the MCP server is running and Node.js is accessible from your PATH. Check the server logs for errors and ensure the absolute paths in your Claude config are correct.

Notes on configuration

If you use a custom NotePlan data directory, you may need to adjust the note management logic in the server to point to your data location. Environmental controls may be added in future versions for easier customization.

Available tools

get_notes

Retrieve all notes or filter by criteria such as folder. Returns a list of notes with basic metadata.

get_note_by_id

Fetch a single note by its unique ID. Returns the note content and metadata.

search_notes

Perform a full-text search across all notes to find matches for your query.

get_notes_by_folder

Retrieve notes contained within a specific folder.

create_note

Create a new note with a title, content, and optional folder organization.

create_daily_note

Create a daily note for a given date with optional initial content.

update_note

Update the title or content of an existing note by its ID.