simple-memo 0.1.0

A simple, MIT-licensed CLI for Apple Notes & Reminders on macOS

simple-memo

A simple, MIT-licensed CLI for Apple Notes & Reminders on macOS.

Use it from the terminal, scripts, or AI agents — no restrictions.

Install

# pip / pipx
pip install simple-memo
# or
pipx install simple-memo

# Homebrew (coming soon)
# brew install inkolin/tap/simple-memo

Notes

simple-memo list                          # List all notes
simple-memo list -f Work                  # List notes in a folder
simple-memo folders                       # List all folders
simple-memo read "Meeting Notes"          # Read a note (Markdown)
simple-memo create "Title" "Body text"    # Create a note
simple-memo create -i                     # Create in $EDITOR
simple-memo create "Title" -f Work        # Create in specific folder
echo "piped" | simple-memo create "Title" # Create from stdin
simple-memo edit "Meeting Notes"          # Edit in $EDITOR
simple-memo append "Title" "More text"    # Append to a note
simple-memo move "Title" "Archive"        # Move to folder (creates if needed)
simple-memo search "keyword"              # Search by content/title
simple-memo search --fzf                  # Interactive fuzzy search (requires fzf)
simple-memo delete "Old Note"             # Delete a note
simple-memo count                         # Count total notes
simple-memo export                        # Export all to ~/Desktop/simple-memo-export/
simple-memo export -o ./backup            # Export to custom directory
simple-memo export --html                 # Export as HTML instead of Markdown
simple-memo mkfolder "Projects"           # Create a folder
simple-memo rmfolder "Old Stuff"          # Delete a folder

Reminders

simple-memo rem list                      # List non-completed reminders
simple-memo rem list -a                   # List all (including completed)
simple-memo rem add "Buy milk"            # Create reminder (no due date)
simple-memo rem add "Meeting" -d 2025-03-01 -t 14:00  # With due date
simple-memo rem done "Buy milk"           # Mark as completed
simple-memo rem edit "Meeting" --new-title "Team sync"  # Rename
simple-memo rem edit "Meeting" --new-date "2025-03-05 10:00"  # Reschedule
simple-memo rem delete "Old reminder"     # Delete

Why?

Existing Apple Notes CLI tools use restrictive licenses that prohibit AI usage. simple-memo is MIT-licensed — use it however you want, including with AI agents, commercial products, and automation scripts.

Requirements

• macOS (uses AppleScript to talk to Apple Notes & Reminders)
• Python 3.9+
• Optional: fzf for interactive search

License

MIT — see LICENSE