Apple Notes CLI — list, search, show, create. Built for humans and agents.
Project description
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.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mac_inotes-0.1.0.tar.gz.
File metadata
- Download URL: mac_inotes-0.1.0.tar.gz
- Upload date:
- Size: 6.4 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
aa3dc68376fe3be3200f8a43196be3f953d8940b8ff405df230661ee9cbe0346
|
|
| MD5 |
5ea6e72bf7164b25df5f8e648df08130
|
|
| BLAKE2b-256 |
dfb1cda439cae70c4a282d659448a569afc58123789d91c69a39c7ccea9f88aa
|
File details
Details for the file mac_inotes-0.1.0-py3-none-any.whl.
File metadata
- Download URL: mac_inotes-0.1.0-py3-none-any.whl
- Upload date:
- Size: 7.0 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a808311c214fffebe24cc6ac6d3e4f7b027e76903612aac43bde0ee8db8cca60
|
|
| MD5 |
022d61c855c7cb1255682d5906a502ed
|
|
| BLAKE2b-256 |
4b963b2074be47cc17e4d731efe311ad799e3d66ffa6dc40167c1d196ffc24a8
|
