NotePlan MCP Server

A Message Control Protocol (MCP) server that enables Claude Desktop to interact with NotePlan.co. This server provides seamless integration between Claude and your NotePlan notes, allowing you to query, search, create, and update notes directly from Claude conversations.

Features

Read Notes: Get all notes, specific notes by ID, or notes from specific folders
Search: Full-text search across all your notes
Create Notes: Create new notes with titles, content, and folder organization
Daily Notes: Create and manage daily notes with automatic date formatting
Update Notes: Modify existing note titles and content
Folder Organization: Organize and filter notes by folders

Installation

Option 1: Clone from GitHub

git clone https://github.com/bscott/noteplan-mcp.git
cd noteplan-mcp
npm install

Option 2: Install as NPM Package (Coming Soon)

npm install -g noteplan-mcp

Quick Start

Install dependencies:
npm install
Build the project:
npm run build
Test the server:
npm start
You should see: "NotePlan MCP server running on stdio"
Configure Claude Desktop (see detailed setup below)

Claude Desktop Configuration

To use this MCP server with Claude Desktop, add the following configuration to your Claude Desktop config file:

Step 1: Locate Your Config File

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

Step 2: Add NotePlan MCP Server

Add this configuration to your claude_desktop_config.json:

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

Important: Replace /absolute/path/to/noteplan-mcp with the actual path where you cloned this repository.

Step 3: Restart Claude Desktop

After saving the configuration, restart Claude Desktop completely for the changes to take effect.

Available Tools

Once configured, you can use these tools in Claude conversations:

Tool	Description	Parameters
`get_notes`	Get all notes from NotePlan	None
`get_note_by_id`	Get a specific note by ID	`id` (required)
`search_notes`	Search notes by query	`query` (required)
`get_notes_by_folder`	Get notes from a folder	`folder` (required)
`create_note`	Create a new note	`title` (required), `content`, `folder`
`create_daily_note`	Create a daily note	`date` (YYYY-MM-DD), `content`
`update_note`	Update existing note	`id` (required), `title`, `content`

Example Usage in Claude

Once set up, you can ask Claude things like:

"Show me all my notes"
"Search for notes containing 'project planning'"
"Create a new note titled 'Meeting Notes' in the 'Work' folder"
"Get today's daily note"
"Update note ID 'note123' with new content"

Claude will automatically use the appropriate NotePlan MCP tools to fulfill these requests.

Development

Development Mode

npm run dev

This builds the TypeScript and starts the server with auto-restart on file changes using nodemon.

Building

npm run build

Compiles TypeScript to JavaScript in the build/ directory.

Testing

npm test

Linting

npm run lint

Project Structure

noteplan-mcp/
├── src/
│   ├── index.ts               # Main MCP server implementation
│   ├── index.js               # HTTP server (alternative)
│   └── services/
│       └── noteService.ts     # Note management logic
├── build/                     # Compiled JavaScript output
│   ├── index.js               # Compiled MCP server
│   └── services/
│       └── noteService.js     # Compiled note service
├── tests/
│   └── index.test.js          # Test files
├── tsconfig.json              # TypeScript configuration
├── package.json
└── README.md

Troubleshooting

Claude Desktop Not Connecting

Check file paths: Ensure the paths in claude_desktop_config.json are absolute and correct
Check Node.js: Make sure Node.js is installed and accessible from your PATH
Check logs: Look for error messages in Claude Desktop's logs:
- macOS: ~/Library/Logs/Claude/mcp-server-noteplan.log
- Windows: %LOCALAPPDATA%\Claude\Logs\mcp-server-noteplan.log

Common Error Messages

"Cannot find module '/src/mcp-server.js'"

The path in your config is incorrect. Use absolute paths, not relative ones.

"Server disconnected"

Check that Node.js is installed and the server can start with npm start

Testing Your Setup

Test the server manually:
cd /path/to/noteplan-mcp npm run build npm start
Use the MCP inspector for debugging:
npm run inspector
Check Claude Desktop logs for connection status
Try a simple command in Claude: "Can you show me my notes?"

Configuration

Custom NotePlan Directory

By default, the server looks for NotePlan files in standard locations. If you use a custom directory, you can modify the noteService.js file to point to your NotePlan data directory.

Environment Variables

Currently, no environment variables are required, but future versions may support:

NOTEPLAN_DATA_DIR: Custom NotePlan data directory
MCP_LOG_LEVEL: Logging verbosity

Contributing

Fork the repository
Create a feature branch: git checkout -b my-new-feature
Make your changes and add tests
Run the test suite: npm test
Run the linter: npm run lint
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
Submit a pull request

License

MIT License - see LICENSE file for details.

Support

Open an issue on GitHub for bugs or feature requests
Check the MCP Documentation for general MCP questions
Review Claude Desktop documentation for setup issues

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

A Message Control Protocol server that enables Claude Desktop to interact with NotePlan.co, allowing users to query, search, create, and update notes directly from Claude conversations.

Related MCP Servers

Calculator MCP Server
QuantGeekDev
-
security
F
license
-
quality
A Model Context Protocol server built with mcp-framework that allows users to create and manage custom tools for processing data, integrating with the Claude Desktop via CLI.
Last updated -
48
4
TypeScript
ClaudeKeep
sdairs
A
security
A
license
A
quality
An MCP server that enables saving and sharing Claude Desktop conversations, allowing users to store chats privately or make them public through a web interface.
Last updated -
2
6
TypeScript
MIT License
MCP Memory Server
ebailey78
-
security
F
license
-
quality
A Model Context Protocol server for Claude Desktop that provides structured memory management across chat sessions, allowing Claude to maintain context and build a knowledge base within project directories.
Last updated -
TypeScript
MCP Easy Copy
f-is-h
A
security
A
license
A
quality
A Model Context Protocol server that automatically reads the Claude Desktop configuration file and presents all available MCP services in an easy-to-copy format at the top of the tools list.
Last updated -
1
1
3
JavaScript
MIT License

View all related MCP servers

NotePlan MCP Server