Skip to content

[Feature Request] CLI interface for AI agent integration #15000

@amdhelper

Description

@amdhelper

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:

  1. 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
  2. Write

    • joplin-cli note create --title <title> --body <md> --notebook <name>
    • joplin-cli note update <id> --body <md>
  3. Tags & Organization

    • joplin-cli tags list
    • joplin-cli notes by-tag <tag>
  4. 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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions