Notes MCP

🚀 Notes MCP

An MCP server that connects with your Apple Notes on macOS, enabling seamless interaction with your notes.

🚀 Quick Start

✨ Features

• notes-get-folders: Retrieve all folders.
• notes-get-notes: Fetch all notes within a specific folder.
• notes-create-note: Generate a new note with a specified title and content.
• notes-get-note-by-id: Obtain a note using its unique identifier.
• notes-get-note-by-title: Locate a note through an exact title match.
• notes-get-note-count: Determine the total number of notes.

📦 Installation

Always install dependencies and build the project first:

npm install && npm run build

💻 Usage Examples

Basic Usage

With Claude for Desktop

Add the following configuration to your ~/Library/Application\ Support/Claude/claude_desktop_config.json:

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

Then, verify that it is running in the Claude settings:

With Cursor

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

After that, check the Cursor MCP settings:

Advanced Usage

Standalone or for other projects

node dist/index.js

📄 License

Notes MCP is licensed under the MIT License.