Installation

clawhub install killgfat/joplin-api

Summary

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

SKILL.md

Joplin API Skill

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


Environment Variables

VariableRequiredDefaultDescription
JOPLIN_BASE_URLNohttp://localhost:41184Joplin API URL
JOPLIN_TOKENYes-API Token from Web Clipper

Quick Start

1. Get API Token

  1. Open Joplin → ToolsOptionsWeb Clipper
  2. Enable service and copy the token

2. Test Connection

bash
python3 joplin.py ping

Basic Commands

bash
python3 joplin.py ping                    # Test connection
python3 joplin.py create --title "Title"  # Create note
python3 joplin.py search "keyword"        # Search
python3 joplin.py list --type notes       # List notes
python3 joplin.py stats                   # Statistics

Security

  • Import/Export restricted to workspace directory
  • Sensitive system directories blocked

Documentation

  • references/API.md - Full API reference
  • references/CONFIGURATION.md - Configuration examples

Recommended skills

Browse all →

Related guides

Hand-picked reading to help you choose, install, and use agent skills.