How do I install the Usememos skill?

Run npx skillmds add modbender/usememos in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Usememos skill do?

Interact with UseMemos — a lightweight, self-hosted memo hub. Create, search, list memos and upload attachments. It is listed under Integrations & APIs on SkillMD.

Is Usememos safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Usememos?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Usememos free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Usememos?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Usememos by modbender — Agent Skill

Name: Usememos
Rating: 4.5 (4 reviews)
Author: modbender

File contents

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

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

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.

Frequently asked questions