Joplin Api

该 Skill 提供一组 Python 命令行脚本，连接 Joplin Data API，用于笔记、笔记本和标签的增删改查、搜索、统计以及 Markdown 文件的导入导出，需配置 API 令牌，导入导出限制在工作区目录内。

killgfat

热度 66.89

最近更新 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