Skip to main content
skill CX Codex

cli-anything-joplin — Claude Code skill: Joplin CLI automation

cli-anything-joplin is a Claude Code skill that manages Joplin notes, notebooks, to-dos and tags through the terminal backend. The agent exports data and syncs the project without opening the GUI.

Apache-2.0 299 installs ★ 62,125 updated 2026-09-22

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add HKUDS/CLI-Anything --skill cli-anything-joplin -a claude-code
Open on GitHub

What cli-anything-joplin does

The skill wraps the Joplin terminal binary in a stateful Python harness: the agent runs a command through cli-anything-joplin, gets JSON with ok, command, data and error fields, and can persist the project in a file for multi-step workflows.

Includes command groups for notebooks (notebooks list, create, use), notes (notes create, set, get, move, rename), to-dos (todos toggle, clear, done), tags (tags add, remove), search (search run), sync (sync run --target), import and export (interop import, export), config (config get, set), attachments (attach add), encryption (e2ee decrypt), and project management (project new, save, status). Requires Python 3.10+ and the joplin binary in PATH; search only works in GUI builds of Joplin — the CLI version returns "only available in GUI mode". Joplin 3.6.x on npm has a broken version command; the skill falls back to package metadata, checking the binary symlink, the sibling node_modules/joplin, the parent lib/node_modules/joplin, and npm root -g.

The agent should use --json for parseable output, --project to save history in multi-step tasks, and --dry-run for test runs without saving. REPL mode does not auto-save — the agent calls project save explicitly.

What it helps with

  • automate note and notebook creation in Joplin
  • export Joplin notes and settings without GUI
  • toggle to-do status and apply tags
  • sync a Joplin project on agent command
  • run search or import data through CLI

Example prompts for the agent

  • Create a Meetings notebook in Joplin and add a note "Standup 12.01" inside.
  • Run cli-anything-joplin --json notes list and show all notes.
  • Toggle the to-do tagged urgent to done.

How to install cli-anything-joplin

1Skills CLI (Vercel)

npx skills add HKUDS/CLI-Anything --skill cli-anything-joplin -a claude-code

2Manually: put the files in place

~/.claude/skills/cli-anything-joplin/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cli-anything-joplin/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about cli-anything-joplin

How do I install cli-anything-joplin in Claude Code?

Run npx skills add HKUDS/CLI-Anything --skill cli-anything-joplin -a claude-code; the skill file lands in ~/.claude/skills/cli-anything-joplin/SKILL.md.

What does cli-anything-joplin do?

Lets the agent manage Joplin notes, notebooks, to-dos, tags and sync through CLI. The skill runs commands against the joplin terminal backend, receives JSON replies and persists project state in a file for multi-step tasks.

Does the skill require the Joplin GUI?

No, it works with the terminal joplin binary without GUI. But search run needs a GUI build — the pure CLI returns "only available in GUI mode".

Source text

SKILL.md · Apache-2.0
---
name: "cli-anything-joplin"
description: "Command-line interface for Joplin workflows using the real joplin terminal backend"
---

# cli-anything-joplin

Use this skill to automate Joplin notebook, note, to-do, tag, attachment,
search, sync, and import/export workflows through a stateful harness backed by
the real `joplin` terminal binary.

## Requirements

- Python 3.10+
- Joplin terminal binary available as `joplin`
- Optional: pass `--profile` to target a specific Joplin profile

## Install

```bash
cd joplin/agent-harness
pip install -e .
```

## Usage

```bash
# REPL mode (default)
cli-anything-joplin

# Machine-readable one-shot command
cli-anything-joplin --json notebooks list

# Stateful project
cli-anything-joplin project new --name demo -o ./demo.joplin-harness.json
cli-anything-joplin --project ./demo.joplin-harness.json notes create "Meeting note"

# Dry-run (no auto-save)
cli-anything-joplin --json --dry-run --project ./demo.joplin-harness.json notes create temp
```

## JSON output contract

When `--json` is enabled, commands return:

- `ok`: boolean
- `command`: stable command identifier such as `notes.list`, `todos.toggle`
- `data`: command payload
- `error`: null on success, or `{ type, message }` on failure

## Command groups

- `project`: `new`, `open`, `save`, `info`, `json`, `status`
- `notebooks`: `list`, `create`, `use`, `remove`
- `notes`: `list`, `create`, `set`, `get`, `remove`, `copy`, `move`, `rename`
- `todos`: `list`, `create`, `toggle`, `clear`, `done`, `undone`
- `tags`: `list`, `add`, `remove`, `notetags`, `tagnotes`
- `search`: `run`
- `sync`: `run` (`--target`, `--upgrade`, `--use-lock`)
- `interop`: `import`, `export`
- `config`: `get`, `set`, `list`, `export`, `import-file`
- `attach`: `add`
- `status`: `show`, `restore`
- `backend`: `version`, `dump`, `keymap`, `geoloc`, `export-sync-status`
- `server`: `status`, `start`, `stop`
- `e2ee`: `status`, `target-status`, `decrypt`, `decrypt-file`
- `session`: `status`, `undo`, `redo`, `history`

## Agent guidance

- Prefer `--json` for parseable output.
- Use `--project` when running multi-step workflows so history is persisted.
- One-shot mutating commands auto-save the project unless `--dry-run` is set.
- REPL mode does not auto-save; run `project save` explicitly.
- Some Joplin CLI builds gate `search` behind GUI mode; if you see
  `"only available in GUI mode"`, treat search as best-effort.
- Joplin 3.6.x can have a broken `version` command in npm global layouts; the
  harness falls back to installed package metadata for `backend version`,
  probing the symlink-resolved binary directory, the Windows-style sibling
  `node_modules/joplin`, the Unix-style parent `lib/node_modules/joplin`, and
  finally `npm root -g`.
- Backend `stdout`/`stderr` in command results are verbatim; do not assume
  warnings were stripped from note bodies or exports.
- On failure, parse `error` using the same `command` field as success
  (`config.import_file`, `e2ee.decrypt_file`). Multi-word subcommands use
  a single dot between group and subcommand.

## Test workflow

```bash
# Quick feedback loop
python -m pytest -q cli_anything/joplin/tests/test_core.py
python -m pytest -q cli_anything/joplin/tests/test_full_e2e.py::TestCLISubprocess

# Real backend (joplin must be in PATH)
python -m pytest -v cli_anything/joplin/tests/test_full_e2e.py::TestBackendCommands
python -m pytest -v cli_anything/joplin/tests/test_full_e2e.py::TestBackendWorkflows
python -m pytest -v cli_anything/joplin/tests/test_full_e2e.py::TestBackendIntegration

# Full suite
python -m pytest -v --tb=no cli_anything/joplin/tests

# Verify the installed console script entry point
CLI_ANYTHING_FORCE_INSTALLED=1 python -m pytest -v -s cli_anything/joplin/tests/test_full_e2e.py
```

Current validation baseline (Windows + Joplin CLI 3.6.2):

- `python -m pytest -q cli_anything/joplin/tests/test_core.py` -> `107 passed`
- `python -m pytest -q cli_anything/joplin/tests` -> `134 passed, 1 skipped`

© HKUDS · Apache-2.0 · HKUDS/CLI-Anything

Similar skills

All skills for Notes, tasks and projects →

From the same set69

The whole set →
cli-anything-rekordbox The cli-anything-rekordbox skill drives Pioneer Rekordbox 6/7's library and live decks from a CLI: playlists, track search, play/sync/crossfade/EQ. CX Codex +1 353installs cli-anything-minimax The cli-anything-minimax skill gives coding agents a MiniMax CLI for chat, streamed responses, and speech synthesis through the MiniMax API. CX Codex +1 350installs cli-anything-hermes cli-anything-hermes — a Hermes agent skill that builds CLI wrappers over graphical applications and repositories. Wraps any software into a command-line interface with stateful sessions, undo/redo, and JSON output. CX Codex +1 314installs cli-anything-live2d cli-anything-live2d provides 42 terminal commands to inspect, edit, lint, and deploy Live2D Cubism models without running Live2D Editor. CX Codex +1 299installs cli-anything-ccswitch The cli-anything-ccswitch skill gives an agent terminal access to CC Switch settings, including providers, proxy state, MCP servers, skills, sessions, and usage data. CX Codex +1 272installs cli-anything-eez-studio cli-anything-eez-studio is a Claude Code skill that gives agents CLI access to EEZ Studio for editing .eez-project files, placing LVGL widgets, and building SCPI command trees. CX Codex +1 266installs cli-anything-wavetone cli-anything-wavetone prepares JSON manifests and opens WaveTone 2.61 for audio transcription. Built for agents handling tempo settings, labels, and audio checks on Windows. CX Codex +1 265installs cli-anything-jumpserver The cli-anything-jumpserver skill gives agents a CLI for JumpServer administration through its REST API, including assets, users, permissions, accounts, sessions, and audit data. CX Codex +1 258installs

Project sponsors

Companies that keep this analytics open