Background
I use OpenClaw, an AI agent platform, alongside Joplin for note-taking. Joplin contains my knowledge base, project notes, and daily logs that would be invaluable for an AI agent to reference.
Problem
Joplin has no CLI for external tools to query notes. The existing joplin CLI is for the terminal app's internal use, not for external programmatic access.
Feature Request
Add a lightweight CLI/API for AI agents:
-
Search & Read
joplin-cli search <query> --limit 10 — search notes, return JSON
joplin-cli note get <id> — get note content as Markdown
joplin-cli notebooks list — list notebook tree
-
Write
joplin-cli note create --title <title> --body <md> --notebook <name>
joplin-cli note update <id> --body <md>
-
Tags & Organization
joplin-cli tags list
joplin-cli notes by-tag <tag>
-
Recent Activity
joplin-cli notes recent --since 7d — recently modified notes
Use Case
An AI agent could:
- Search the user's notes when answering questions (personal knowledge base)
- Create notes from conversations automatically
- Update project tracking notes
- Reference past decisions and meeting notes
This makes Joplin a personal RAG (Retrieval-Augmented Generation) source for AI agents.
Implementation
- Could expose the existing Joplin Server/Data API on localhost
- Or add a
--json flag to the existing terminal CLI
- Read-only mode as default for safety
Background
I use OpenClaw, an AI agent platform, alongside Joplin for note-taking. Joplin contains my knowledge base, project notes, and daily logs that would be invaluable for an AI agent to reference.
Problem
Joplin has no CLI for external tools to query notes. The existing
joplinCLI is for the terminal app's internal use, not for external programmatic access.Feature Request
Add a lightweight CLI/API for AI agents:
Search & Read
joplin-cli search <query> --limit 10— search notes, return JSONjoplin-cli note get <id>— get note content as Markdownjoplin-cli notebooks list— list notebook treeWrite
joplin-cli note create --title <title> --body <md> --notebook <name>joplin-cli note update <id> --body <md>Tags & Organization
joplin-cli tags listjoplin-cli notes by-tag <tag>Recent Activity
joplin-cli notes recent --since 7d— recently modified notesUse Case
An AI agent could:
This makes Joplin a personal RAG (Retrieval-Augmented Generation) source for AI agents.
Implementation
--jsonflag to the existing terminal CLI