Joplin CLI Skill

Comprehensive Joplin notes management with wrapper scripts, templates, and automation workflows.

Features

• Full Joplin CLI Integration – Direct access to all Joplin commands
• Wrapper Scripts – Pre-built scripts for common workflows
• Templates – Daily journals, meeting notes, project updates
• Error Handling – Robust installation and configuration checks
• Multi-language – German and English support
• Integration Ready – Works with Gmail, Calendar, Web Fetch skills

Prerequisites

1. Joplin CLI installed globally:

   npm install -g joplin
   

2. Joplin configured (optional but recommended for sync):

   joplin config sync.target 10  # Joplin Cloud
   joplin config sync.10.username [email protected]
   joplin config sync.10.password your-password
   

Quick Start

1. Check Joplin Installation

./scripts/joplin-check.sh health

2. Create a Quick Note

./scripts/joplin-quick-note.sh "My First Note" "This is my first note."

3. Create Daily Journal

./scripts/joplin-daily-journal.sh

Available Scripts

Joplin CLI Quick Reference

Basic Commands

Tag Management

Sync & Status

Import/Export

Workflow Examples

Daily Journal Routine

# Create today's journal
./scripts/joplin-daily-journal.sh

# Review yesterday's journal
joplin cat "Journal $(date -d 'yesterday' +'%Y-%m-%d')"

# Sync to cloud
joplin sync

Advanced Search

# Search notes with filters
./scripts/joplin-search-notes.sh "project meeting" -t work -n Projects

# Export search results to JSON
./scripts/joplin-search-notes.sh "important OR urgent" -f json -o results.json

# Search with date filters
./scripts/joplin-search-notes.sh "updated:2026-03" -s created -r

Automated Backups

# Daily backup with encryption
./scripts/joplin-export-backup.sh --sync-first --encrypt --password "secret"

# Test backup without actually exporting
./scripts/joplin-export-backup.sh --test

# Backup to specific directory
./scripts/joplin-export-backup.sh /mnt/backup/joplin --keep-days 7

Meeting Notes

# Create meeting notes with template
./scripts/joplin-daily-journal.sh --template meeting --title "Team Meeting"

# Add action items
joplin edit "Team Meeting"

Quick Capture

# Quick note with tags
./scripts/joplin-quick-note.sh "Project Idea" "Build a new dashboard" -t "ideas,projects"

# From stdin
echo "Remember to call client" | ./scripts/joplin-quick-note.sh "Reminder"

Integration with Other Skills

Gmail → Joplin

# Save important emails as notes
# (Combine with gog skill)

Calendar → Joplin

# Create notes from calendar events
# (Combine with gog calendar skill)

Web Fetch → Joplin

# Save web articles as notes
web_fetch --url https://example.com --extract-mode markdown | \
  ./scripts/joplin-quick-note.sh "Web Article" "$(cat -)" "web,research"

Configuration

Environment Variables

export JOPLIN_DEFAULT_NOTEBOOK="Inbox"
export JOPLIN_DEFAULT_TAGS="todo,important"
export JOPLIN_JOURNAL_NOTEBOOK="Journal"
export JOPLIN_JOURNAL_TAGS="journal,daily"
export JOPLIN_DATE_FORMAT="%Y-%m-%d"
export EDITOR="code --wait"

Joplin Configuration for Scripts

# Optimize for CLI usage
joplin config cli.disablePrompts true
joplin config cli.suppressTui true
joplin config editor "$EDITOR"

Troubleshooting

Joplin Not Found

Error: Joplin CLI not found

Solution:

npm install -g joplin

Sync Errors

Error: Sync failed

Solution:

joplin config --list | grep sync
joplin sync --test

Permission Issues

Error: Cannot write to Joplin data directory

Solution:

chmod 755 ~/.config/joplin/

Tips & Best Practices

1. Always Sync – Run joplin sync after making changes
2. Use Tags – Tag notes for better organization
3. Regular Backups – Export notes periodically
4. Notebook Structure – Organize by project, area, or context
5. Template Consistency – Use consistent templates for similar notes

References

• references/joplin-config-example.md – Configuration examples
• references/common-workflows.md – Common workflows
• Joplin Documentation – Official docs
• ClawHub Skills – More skills

Development

Project Structure

joplin-cli/
├── SKILL.md                    # This file
├── README.md                   # ClawHub README
├── package.json                # ClawHub metadata
├── scripts/                    # Wrapper scripts
│   ├── joplin-check.sh        # Health check
│   ├── joplin-quick-note.sh   # Quick notes
│   └── joplin-daily-journal.sh # Daily journals
└── references/                 # Examples & configuration

Adding New Scripts

1. Create script in scripts/ directory
2. Include error handling with joplin-check.sh
3. Document in README.md and SKILL.md
4. Test with real Joplin installation

License

MIT License – See LICENSE file.

Happy Note-Taking! 📝