Skip to main content
Glama
ml-lubich

apple-notes-mcp

by ml-lubich
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python

inotes — Apple Notes CLI (+ MCP)

Package brand: inotes-mcp · CLI: inotes · PyPI today: pip install mac-inotes (renaming to inotes-mcp when PyPI new-project limit clears).

imsg-style local Notes tool. Name family: imsg · imail · inotes · wa.

Surface

Binary

When

CLI (prefer)

inotes

list/search/show/create — saves tokens

MCP

apple-notes-mcp

rich CRUD in agents

Install

pip (editable dev):

git clone https://github.com/ml-lubich/inotes.git
cd inotes
python3 -m pip install -e ".[dev]"

Homebrew (when published):

brew install ml-lubich/tap/inotes

Requires macOS with Notes.app. Grant Automation → Notes when prompted.

Usage

inotes doctor
inotes list --limit 20
inotes list --json
inotes search "standup" --limit 10 --json
inotes show "My Note"
inotes create --title "Idea" --body "…"
inotes create --title "Work" --body "…" --folder "Projects"
inotes version
inotes -h

Agents

CLI-first — use MCP only when you need operations beyond this surface.

inotes agent schema   # JSON command contract (version, tool, params)
inotes agent guide    # markdown playbook

Pair with sweetrb/apple-notes-mcp for full MCP tooling.

Development

python3 -m pip install -e ".[dev]"
pytest -q
inotes -h

Legacy bash implementation preserved as inotes.bash.bak.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Related MCP Connectors