Joplin Api

Manage Joplin notes via REST API. Use for creating, reading, updating, deleting, or searching Joplin notes programmatically.

Audits

Pass

ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install joplin-api

Joplin API Skill

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

Environment Variables

Variable	Required	Default	Description
`JOPLIN_BASE_URL`	No	`http://localhost:41184`	Joplin API URL
`JOPLIN_TOKEN`	Yes	-	API Token from Web Clipper

Quick Start

1. Get API Token

Open Joplin → Tools → Options → Web Clipper
Enable service and copy the token

2. Test Connection

python3 joplin.py ping

Basic Commands

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