LaunchKit · 2026
Back to Skills

joplin-api

Manage Joplin notes, notebooks, and tags via Joplin Data API.

3
396 downloads
by @killgfat

Setup & Installation

openclaw skills install @killgfat/joplin-api

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install joplin-api

Version History

v0.1.3Mar 2, 2026 - Version note by skill developer:

Removed all .env location references from code and documentation

What This Skill Does

Connects to a running Joplin desktop app via its local REST API to manage notes, notebooks, and tags programmatically. Supports creating, reading, updating, deleting, and searching notes through a Python script wrapper.

Lets agents interact with Joplin's full data model without leaving the terminal, avoiding manual UI navigation for repetitive note operations.

When to use it

  • Automatically filing meeting notes into specific notebooks
  • Searching notes for a keyword and extracting matching content
  • Bulk-creating notes from structured data
  • Listing all notes in a notebook for review
  • Checking note statistics across the entire library

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: 'Create a note titled "Q1 Review" in my Work notebook'

AGENT
  1. 1Calls ping to verify Joplin is running and API is reachable
  2. 2Searches for the Work notebook by name to get its ID
  3. 3Calls create with the title and parent notebook ID
  4. 4Confirms the note was created by fetching its metadata
OUTPUT

Note "Q1 Review" created in the Work notebook with the returned note ID

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

JOPLIN_TOKEN environment variable (from Joplin desktop app: Tools > Options > Web Clipper)Joplin desktop app running locally with Web Clipper service enabled