Apple Notes MCP

MCP server for Apple Notes on macOS.

Provides access to notes and folders for creation, organization, and management. Keep Notes as the system of record while enabling agents to read, create, update, move, and delete notes.

When to use

  • Notes-only workflows
  • Stronger isolation than the all-in-one server
  • Structured note and folder operations through the native Notes app

What It Does

  • List accounts and folders
  • List, search, and manage notes (CRUD)
  • Create, rename, and delete folders
  • List note attachments
  • Tool discovery helpers search_tools and get_tool_info for context-constrained clients
  • Recent-note resources and organization prompts
  • Health and permission checks: notes_health, notes_permission_guide, notes_recheck_permissions

Install On This Mac

Quick start (uvx, from PyPI)

With uv installed:

uvx apple-mcp-notes

No clone, no venv management.

From a clone 
git clone https://github.com/JonathanRReed/Apple-MCPs.git
cd Apple-MCPs
uv sync --all-packages

This builds one workspace environment with every server's entry point in .venv/bin (for example .venv/bin/apple-notes-mcp). You can also point an MCP client at AppleNotes-MCP/start.sh, which prefers uv run and falls back to a plain venv bootstrap (Python 3.11+ required).

Install In AI Agents

Generic MCP client config 
{
  "mcpServers": {
    "apple-notes": {
      "command": "uvx",
      "args": ["apple-mcp-notes"],
      "env": {
        "APPLE_NOTES_MCP_SAFETY_MODE": "full_access"
      }
    }
  }
}

Running from a clone instead? Use /path/to/Apple-MCPs/AppleNotes-MCP/start.sh as the command with empty args.

Claude Code example 
claude mcp add --transport stdio --scope project apple-notes -- uvx apple-mcp-notes

Safety Modes

  • safe_readonly
  • safe_manage
  • full_access

Transport

stdio is the default and recommended transport. Set APPLE_NOTES_MCP_TRANSPORT=streamable-http (with optional APPLE_NOTES_MCP_HOST and APPLE_NOTES_MCP_PORT) to serve Streamable HTTP instead.

macOS Permissions

  • Automation access to Notes is required

Launch Checklist

  • Add uvx apple-mcp-notes (or a clone's AppleNotes-MCP/start.sh) to your MCP client
  • Reload or reconnect the client so the Notes tool surface is loaded into context
  • Call notes_health first
  • If Notes automation is blocked, call notes_permission_guide
  • After changing macOS permissions, call notes_recheck_permissions

Prompting Notes

  • tools/list returns the full Notes tool surface. Context-constrained clients can use search_tools first, then get_tool_info for the Notes tool they need.
  • Multiple accounts may each contain a Notes folder. Identify available accounts and folders on first use and set a default.
  • Use Notes for reference material and saved context.
  • Time-sensitive items should go to Reminders or Calendar instead.

Related

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.0.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for JonathanRReed from gravatar.com JonathanRReed

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Provides Extra

dev

Tags

mcp model-context-protocol macos apple ai-agent automation

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

apple_mcp_notes-1.0.1.tar.gz (20.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

apple_mcp_notes-1.0.1-py3-none-any.whl (27.5 kB view details)

Uploaded Python 3

File details

Details for the file apple_mcp_notes-1.0.1.tar.gz.

File metadata

  • Download URL: apple_mcp_notes-1.0.1.tar.gz
  • Upload date:
  • Size: 20.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for apple_mcp_notes-1.0.1.tar.gz
Algorithm Hash digest
SHA256 dcb9aaf06bf389bf10a38878c0a45028f5309c03d56ce83adffff6b62ce9c801
MD5 bf6148309765f0e74a1df53f5ddc94fb
BLAKE2b-256 f6635dbfc9ed0e8cc995ea13ae4f81dc91ec286e2728f73f118285be0f942c97

See more details on using hashes here.

Provenance

The following attestation bundles were made for apple_mcp_notes-1.0.1.tar.gz:

Publisher: release.yml on JonathanRReed/Apple-MCPs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file apple_mcp_notes-1.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for apple_mcp_notes-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 69ed1d652e44f2a8440b257e3ac1c7bd7185acefe36a89bb027ed4833a27c80a
MD5 841b5a6f67907ecc326d8b49061d3baf
BLAKE2b-256 2a1a05126e61b7b591472bbcf7d75092d8ae30f606ae783d8a2104c2aa2a55c2

See more details on using hashes here.

Provenance

The following attestation bundles were made for apple_mcp_notes-1.0.1-py3-none-any.whl:

Publisher: release.yml on JonathanRReed/Apple-MCPs

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page