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.
1 maintainer
Release files for inotes-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| inotes_mcp-0.1.1.tar.gz | 8.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| inotes_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size:15.4 kB
Release files / inotes_mcp-0.1.1.tar.gz
| Download URL | inotes_mcp-0.1.1.tar.gz |
|---|---|
| Size | 8.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
80f66babf7f7befec8bab9d486936a3c2e2f2ffa5400cfec291e6c2220073643
|
|
BLAKE2b-256 checksum How to use checksums |
04a5e00b868a3ef4b3fc607772c68c94e758a241539ab3212b77380213ba4e3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / inotes_mcp-0.1.1-py3-none-any.whl
| Download URL | inotes_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 7.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
edbf57ed7c3949b95bee803242fed1d42ea611196fb764e6d1d4cb205260c204
|
|
BLAKE2b-256 checksum How to use checksums |
b9395434dd71527f6fa0dc163f16be1c93ef617018f01ddb144e827aa61dfafc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
