UseMemos

Setup

Requires environment variables in .env: - USEMEMOS_URL — Instance URL (e.g., http://localhost:5230) - USEMEMOS_TOKEN — Access token from Settings > My Account

Scripts

Script	Usage	Description
`create_memo.py`	`<content> [visibility]`	Create a memo (visibility: PRIVATE/PROTECTED/PUBLIC)
`list_memos.py`	`[limit] [tag]`	List recent memos (default: 10)
`search_memos.py`	`<query> [limit]`	Search memos by content
`upload_attachment.py`	`<filepath> [filename] [type]`	Upload a file attachment
`upload_and_link_attachment.py`	`<memo_id> <filepath> [filename] [type]`	Upload and link attachment to a memo
`memo_comments.py`	`<list\|add\|delete> [args...]`	Manage comments on a memo

All scripts are in scripts/ and run with python3 scripts/<script>.

Examples

# Create a memo with tags
python3 scripts/create_memo.py "Meeting notes from standup #work"

# List recent memos
python3 scripts/list_memos.py 5

# Search memos
python3 scripts/search_memos.py "website redesign"

# Upload attachment standalone
python3 scripts/upload_attachment.py photo.jpg "sale_photo.jpg" "image/jpeg"

# Create memo then attach a file
python3 scripts/create_memo.py "Sale: Stromer Charger #eBike #income"
# Use the memo ID from output:
python3 scripts/upload_and_link_attachment.py <memo_id> charger_photo.jpg

# Add a comment to a memo
python3 scripts/memo_comments.py add <memo_id> "Looks great!"

# List comments on a memo
python3 scripts/memo_comments.py list <memo_id>

# Delete a comment
python3 scripts/memo_comments.py delete <comment_id>

Notes

Memo IDs are short IDs like 3UZ7uBbHsLEAwdYE5HKhjd (not memos/3UZ7uBbHsLEAwdYE5HKhjd)
Tags use #tag syntax inline in memo content
Default MIME type for attachments is image/jpeg; pass the type explicitly for other files

API Reference

See references/api.md for endpoint documentation.

usememos-api