pi-joplin

A pi extension providing read-only access to Joplin notes

Packages

Package details

extension

Install pi-joplin from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-joplin
Package
pi-joplin
Version
1.0.0
Published
Jun 4, 2026
Downloads
not available
Author
lack_
License
MIT
Types
extension
Size
54.8 KB
Dependencies
5 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "dist/index.js"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-joplin

A pi extension that provides read-only access to Joplin notes.

Features

  • List all notebooks
  • List notes (all notes or filtered by notebook/tag)
  • Read individual notes
  • Get metadata for a specific note (e.g. parent_id, is_todo, created_time, tags, etc.)

Installation

Install via the pi CLI:

pi install npm:pi-joplin

Usage

Once installed, the tools will automatically be available in your sessions.

For local development or testing without installing globally, you can load the extension directly:

pi -e /path/to/pi-joplin/dist/index.js

Requirements

  • Joplin CLI must be installed or the extension will use its internal joplin NPM dependency.
  • The Web Clipper must be enabled inside Joplin Desktop (or you must supply a custom API Token).

Configuration

If you do not use the default profile location, or if you need to manually connect to a headless background server via API token, you can invoke the configuration UI via pi:

/joplin-config

This will prompt you for an API token and a profile path and persist them safely inside your active session.