# Joplin API

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

- Skill: `javimosch/joplin-api` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/joplin-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/joplin-api/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/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

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