name: usememos-api version: "1.0.2" description: Interact with UseMemos — a lightweight, self-hosted memo hub. Create, search, list memos and upload attachments. tags: ["memos", "notes", "self-hosted", "knowledge-base", "attachments"] homepage: https://github.com/minstn/usememos source: https://github.com/minstn/usememos metadata: openclaw: requires: env: - USEMEMOS_URL - USEMEMOS_TOKEN bins: - python3 primaryEnv: USEMEMOS_TOKEN

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

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.