Joplin

Interact with Joplin notes via CLI. Use for reading, creating, editing notes and managing todos. Supports WebDAV sync and kanban-formatted notes.

Security Scan

The skill is internally consistent: it's an instruction-only helper for the Joplin CLI, it doesn't request extra credentials, installs, or code, and the commands shown match the stated purpose.

Purpose & Capability

Name/description (Joplin CLI) match the SKILL.md contents. All commands and examples are Joplin CLI operations; nothing unrelated (no cloud providers, unrelated services, or extra binaries) is requested.

Instruction Scope

Runtime instructions are limited to using the joplin CLI (list, read, create, edit, delete, sync, export, import, kanban formatting). They don't instruct reading unrelated system files or environment variables. They do show examples configuring WebDAV (URL, username, password) which is expected for sync operations.

Install Mechanism

No install spec and no code files — the skill is instruction-only and does not write or fetch code to disk.

Credentials

The skill declares no required environment variables or credentials. The SKILL.md shows how a user might provide WebDAV credentials to Joplin's config, which is proportional to the sync feature and is not requested by the skill itself.

Persistence & Privilege

always is false and there is no install-time persistence. The skill does not request system-wide privileges or modify other skills' configuration.

Assessment

This skill is an instruction-only wrapper for the joplin CLI and appears coherent. Before using it, make sure: (1) you have the joplin CLI installed and trust it; (2) you understand the agent will be instructed to run commands that can modify or delete notes (ask for explicit confirmation before destructive actions); (3) if you configure WebDAV, you only use trusted servers because sync will transmit your notes and credentials; and (4) keep backups of your notes before allowing unattended/automated use. If you want stricter safety, require the agent to prompt you before any rm/sync/import/export operations.

Joplin CLI Skill

Use joplin CLI to interact with Joplin notes.

⚠️ Important: Use CLI, Not SQL

Use the joplin CLI for editing notes. Avoid modifying the SQLite database directly - it can cause sync conflicts and data loss.

Setup

If Joplin is not configured with WebDAV, configure it:

joplin config sync.target 6
joplin config sync.6.path "https://your-webdav-server/path"
joplin config sync.6.username "your-username"
joplin config sync.6.password "your-password"
joplin sync

Common Commands

List Notebooks and Notes

joplin ls                          # List notebooks
joplin ls "Notebook Name"          # List notes in a notebook
joplin status                      # Show sync status and note counts
joplin ls -l                       # List with IDs

Read Note

joplin cat <note-id>               # Display note content
joplin cat "Note Title"            # Also works with title
joplin note <note-id>              # Open note in editor

Create Note

joplin mknote "Note Title"         # Create note in default notebook
joplin mknote "Note Title" --notebook "Notebook Name"
joplin mkbook "New Notebook"       # Create new notebook

Tip: Ask the user which notebook to use. Use:

• joplin use — shows current notebook
• joplin use "Notebook Name" — switch to a notebook
• joplin ls — see all notebooks

Edit Note

joplin edit --note <note-id>       # Edit note in editor
joplin set <note-id> title "New title"  # Change note title

Delete Note

joplin rmnote <note-id>            # Delete note
joplin rmbook "Notebook Name"      # Delete notebook

Move Notes Between Notebooks

joplin mv "Note Title" "Target Notebook"

Todos

joplin todos                       # List all todos
joplin todo <note-id>              # Toggle todo status
joplin done <note-id>              # Mark as done
joplin undone <note-id>            # Mark as not done

Sync

joplin sync                        # Sync with WebDAV server

Export

joplin export <note-id> --format md
joplin export <note-id> --format html
joplin export <note-id> --format pdf

Import

joplin import /path/to/note.md --notebook "Notebook Name"

Search

Note: joplin search is only available in GUI mode. Use joplin ls to list notebooks and notes instead.

All Joplin Commands

attach, batch, cat, config, cp, done, e2ee, edit, export, geoloc, help, 
import, ls, mkbook, mknote, mktodo, mv, ren, restore, rmbook, rmnote, 
server, set, share, status, sync, tag, todo, undone, use, version

Referencing Notes and Notebooks

A note or notebook can be referred to by:

• Title: "Note Title"
• ID: fe889 (get from joplin ls -l)
• Shortcuts:
  • $n — Currently selected note
  • $b — Currently selected notebook
  • $c — Currently selected item

Interactive Shell Mode

Joplin can run interactively (like a shell). Start with just joplin:

joplin                          # Start interactive mode

Shell Commands (prefix with :)

Command	Description
:sync	Sync with WebDAV server
:quit or :q	Exit Joplin
:help	Show help
:open <note-id>	Open a note

Shell Mode Shortcuts

• e — Edit current note
• i — Insert new note
• Space — Select item
• Enter — Open note

Example Workflow

# Create a notebook
joplin mkbook "My notebook"

# Switch to it
joplin use "My notebook"

# Create a note
joplin mknote "My note"

# View notes with IDs
joplin ls -l

# Edit a note's title
joplin set <note-id> title "New title"

Kanban Notes (YesYouKan Plugin)

Some notebooks use the YesYouKan kanban plugin for visual kanban boards. These notes have a specific format that must be preserved when editing:

Kanban Format

# Notebook Name

# Backlog

## Task 1

Description here

## Task 2



# In progress

## Another Task

Details



# Done

## Completed Task

Result

```kanban-settings
# Do not remove this block

### ⚠️ Kanban Formatting Rules

The YesYouKan plugin uses a specific format. Key points:

1. **Kanban settings block** - The kanban-settings block at the end of the note is used by the plugin. Its format should be preserved as shown in the example above.

2. **Use `##` for task headings** (not `#`)

3. **Column headings** should use `# Backlog`, `# In progress`, `# Done`

4. **Blank lines** between tasks are visible in the kanban view

5. **After editing a kanban note, run `joplin sync`** to upload changes

6. **Verify changes with `joplin cat <note-id>`** to ensure formatting is correct

### Moving Tasks Between Columns

When moving a task, simply move the `##` task section from one column to another.