Joplin Api

核心功能为通过Joplin Data API管理笔记、笔记本和标签，支持创建、读取、更新、删除、搜索、统计等操作。典型场景是程序化自动化管理Joplin内容。需配置JOPLIN_TOKEN等环境变量，通过Bash命令调用，导入导出限制在指定目录，提供连接测试等快速操作，适合需批量或自动管理Joplin笔记的用户。

killgfat

热度 66.92

最近更新 2026-05-11 17:26:57

分类：自动化依赖：第三方 API / 读写文件应用场景：笔记整理 / 任务管理 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add joplin-api

Metadata

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

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