- name
- joplin-api
- description
- Manage Joplin notes via REST API. Use for creating, reading, updating, deleting, or searching Joplin notes programmatically.
- allowed-tools
- Bash(joplin-api:*)
- homepage
- https://joplinapp.org/help/api/references/rest_api/
- metadata
- openclaw
- requires
- bins
- [python3]
- install
- kind
- pip
- package
- requests python-dotenv
- label
- Install Python dependencies
- env
- required
- false
- default
- http://localhost:41184
- description
- Joplin Data API base URL
- required
- true
- description
- API Token from Joplin Web Clipper settings
- required
- false
- default
- /root/.openclaw/workspace
- description
- Allowed directory for import operations
- required
- false
- default
- /root/.openclaw/workspace
- description
- Allowed directory for export operations
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 pingBasic 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 # StatisticsSecurity
- Import/Export restricted to workspace directory
- Sensitive system directories blocked
Documentation
references/API.md- Full API referencereferences/CONFIGURATION.md- Configuration examples