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 referencereferences/CONFIGURATION.md- Configuration examples