Archived
This project has been archived by its maintainers, and is no longer receiving any updates.
inotes — Apple Notes CLI (+ MCP)
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
Metadata
1 maintainer
Release files for mac-inotes 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 | |
|---|---|---|---|
| mac_inotes-0.1.1.tar.gz | 6.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mac_inotes-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.4 kB
Release files / mac_inotes-0.1.1.tar.gz
| Download URL | mac_inotes-0.1.1.tar.gz |
|---|---|
| Size | 6.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cbe9c52fa44bc6c6fd379db1b668ce26b1a2d4ca2c5c9135f19bea937a114cd5
|
|
BLAKE2b-256 checksum How to use checksums |
2eaa818880228d34cbbe131b1f9af8e7b390e8ab0405c5a5e2ddc2e7b5bd59dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.23 {"installer":{"name":"uv","version":"0.11.23","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 / mac_inotes-0.1.1-py3-none-any.whl
| Download URL | mac_inotes-0.1.1-py3-none-any.whl |
|---|---|
| Size | 7.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b06f9b913237b34cccfa63cffdfa93d4e60b088c51766babee0ad27c61308ec9
|
|
BLAKE2b-256 checksum How to use checksums |
795ee53b090432bc28e93555c8fa27785285144c0989b595de49ebb1fbffad06
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.23 {"installer":{"name":"uv","version":"0.11.23","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}
|
