Skill: killgfat/joplin-api (version 0.1.3)

--- 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: - id: deps kind: pip package: requests python-dotenv label: Install Python dependencies env: - name: JOPLIN_BASE_URL required: false default: http://localhost:41184 description: Joplin Data API base URL - name: JOPLIN_TOKEN required: true description: API Token from Joplin Web Clipper settings - name: JOPLIN_IMPORT_DIR required: false default: /root/.openclaw/workspace description: Allowed directory for import operations - name: JOPLIN_EXPORT_DIR 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 1. Open Joplin → **Tools** → **Options** → **Web 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

path: clawhub.json
content: {
  "slug": "joplin-api",
  "name": "Joplin API",
  "version": "0.1.3",
  "description": "Manage Joplin notes via REST API - create, read, update, delete, search, and organize notes programmatically",
  "author": "Cortana",
  "changelog": "Removed all .env location references from code and documentation",
  "tags": ["joplin", "notes", "api", "rest", "productivity", "latest"],
  "emoji": "📝",
  "category": "productivity",
  "homepage": "https://joplinapp.org"
}

path: references/CONFIGURATION.md
content: # Joplin Configuration Guide

## Environment Variables

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

---

## Get API Token

1. Open Joplin → **Tools** → **Options** → **Web Clipper**
2. Enable service and copy the token

---

## Test Connection

```bash
python3 joplin.py ping
```

---

## Configuration Examples

```bash
# Local
JOPLIN_BASE_URL=http://localhost:41184

# Remote
JOPLIN_BASE_URL=https://joplin.example.com
```

Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)