Notes MCP Server

This is a Model Context Protocol (MCP) server that provides access to your Apple Notes database.

Features

• Search Notes: Search through all notes by title or content
• Get Specific Note: Retrieve a note by its ID
• List Recent Notes: Get the most recently modified notes
• Resource Access: Access all notes via the notes://all resource

Installation

cd ~/notes-mcp-server
npm install

Configuration for Claude Code

Add this to your Claude Code MCP settings file:

Location: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "notes": {
      "command": "node",
      "args": ["/Users/matthewkarsten/notes-mcp-server/index.js"]
    }
  }
}

Available Tools

1. search_notes

Search through notes by title or content.

Parameters:

• query (string, required): Search query
• limit (number, optional): Max results (default: 10)

2. get_note

Get a specific note by ID.

Parameters:

• note_id (number, required): The note ID

3. list_recent_notes

List recently modified notes.

Parameters:

• limit (number, optional): Number of notes (default: 20)

Usage Examples

Once configured, Claude Code can access your notes using MCP tools:

"Search my notes for blockchain projects"
"Get note with ID 1414"
"Show me my 50 most recent notes"

Notes

• The server connects to your Apple Notes SQLite database in read-only mode
• No notes are modified or deleted
• Content decoding handles binary data gracefully