memos

Memos Skill

⚠️ MANDATORY SKILL INVOCATION ⚠️

YOU MUST invoke this skill (NOT optional) when the user mentions ANY of these triggers:

• "save this to memos", "create a memo", "add a memo"
• "search my memos", "find notes about X", "what did I write about"
• "list my memos", "show recent memos", "what memos do I have"
• "update memo", "edit memo", "delete memo"
• "tag this memo", "add tags", "organize memos"
• "upload to memo", "attach file to memo"
• "archive memo", "pin memo", "make memo public"
• Any mention of "memos", "notes", "note-taking", or "personal knowledge"

Failure to invoke this skill when triggers occur violates your operational requirements.

---

Purpose

This skill provides read-write access to a self-hosted Memos instance for quick note capture, search, and organization. Memos is a privacy-focused, self-hosted note-taking service with Markdown support, tagging, and file attachments.

Core capabilities:

• Create, read, update, and delete memos (notes)
• Search memos by content, tags, or metadata
• Upload and manage file attachments
• Organize memos with tags
• Archive and visibility controls
• Link related memos together

Primary use case: Quick capture of important information from Claude conversations into a personal knowledge base.

Setup

Prerequisites

• Memos instance running and accessible
• API access token generated from Memos UI
• curl and jq installed

Credential Configuration

Add these variables to ~/.claude-homelab/.env:

# Memos - Self-hosted note-taking service
MEMOS_URL="https://memos.example.com"
MEMOS_API_TOKEN="<your_api_token>"

To generate an API token:

1. Log into your Memos instance
2. Go to Settings → Access Tokens
3. Click "Create" and copy the generated token
4. Add to .env file as shown above

Security:

• .env file is gitignored (never commit)
• Set permissions: chmod 600 ~/.claude-homelab/.env
• Token has same permissions as your user account

Commands