Joplin Cli
by @joergbot-cloud
Comprehensive Joplin notes management via CLI with wrapper scripts, templates, and automation. Use when creating, reading, editing, syncing, or organizing no...
clawhub install joplin-notes-proπ About This Skill
name: joplin-notes-pro description: Comprehensive Joplin notes management via CLI with wrapper scripts, templates, and automation. Use when creating, reading, editing, syncing, or organizing notes in Joplin. Includes daily journals, meeting notes, quick notes, and integration with other skills. Triggers on keywords like "joplin", "note", "notiz", "journal", "meeting notes", "daily journal", "notes verwalten". emoji: π
Joplin CLI Skill
Comprehensive Joplin notes management with wrapper scripts, templates, and automation workflows.
Features
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 your-email@example.com
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
| Script | Description | Usage |
|--------|-------------|-------|
| joplin-check.sh | Health check and installation verification | ./joplin-check.sh health |
| joplin-quick-note.sh | Create notes with tags and notebooks | ./joplin-quick-note.sh "Title" "Content" -t tag1,tag2 |
| joplin-daily-journal.sh | Daily journal with templates | ./joplin-daily-journal.sh --template daily |
| joplin-search-notes.sh | Advanced note search with filters | ./joplin-search-notes.sh "query" -t tag -f json |
| joplin-meeting-notes.sh | Meeting notes with templates | ./joplin-meeting-notes.sh "Meeting" -a "Alice,Bob" |
| joplin-integration-starter.sh | Setup integrations with other skills | ./joplin-integration-starter.sh --list |
| joplin-export-backup.sh | Backup all notes | *In development* |
| joplin-meeting-notes.sh | Meeting notes template | *Coming soon* |
Joplin CLI Quick Reference
Basic Commands
| Command | Description | |---------|-------------| |joplin | Start interactive REPL |
| ls | List notes and notebooks |
| ls | List notes in a notebook |
| cat | Show note content |
| mknote | Create new note |
| mkbook | Create new notebook |
| edit | Open note in $EDITOR |
| rmnote | Delete a note |
| rmbook | Delete a notebook |
| mv | Move note to notebook |
| cp | Copy note to notebook |
| ren -
| Rename note or notebook |Tag Management
| Command | Description | |---------|-------------| |tag | List all tags |
| tag | Add tag to note |
| tag --remove | Remove tag |Sync & Status
| Command | Description | |---------|-------------| |sync | Sync with Joplin Cloud/server |
| todo | List all to-dos |
| mktodo | Create a to-do item |
| done | Mark to-do as done |
| undone | Mark to-do as not done |
| status | Show sync status |
| config | Show/change configuration |Import/Export
| Command | Description | |---------|-------------| |export | Export all notes |
| import | Import notes |
| version | Show Joplin version |Workflow Examples
Daily Journal Routine
# Create today's journal
./scripts/joplin-daily-journal.shReview 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 ProjectsExport search results to JSON
./scripts/joplin-search-notes.sh "important OR urgent" -f json -o results.jsonSearch 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 --testBackup 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 examplesreferences/common-workflows.md β Common workflowsDevelopment
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 inscripts/ directory
2. Include error handling with joplin-check.sh
3. Document in README.md and SKILL.md
4. Test with real Joplin installationLicense
MIT License β See LICENSE file.
Happy Note-Taking! π
π‘ Examples
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
βοΈ 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"
π Tips & Best Practices
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/