Joplin AI Tag Suggester

Suggest relevant tags for your Joplin notes using AI.

Providers:

• Gemini (default)
• OpenRouter

Installation

Prerequisites: Node.js, Joplin Desktop.

1. Install dependencies

npm install

2. Build the plugin and pack a .jpl

npm run dist

3. In Joplin Desktop, go to Tools → Options → Plugins → Install from file and select the generated .jpl in the publish/ folder.

Configuration

Open Joplin → Tools → Options → AI Tag Suggester.

Settings in src/index.ts are registered as Joplin settings:

• provider: "gemini" or "openrouter" (default: gemini)
• geminiApiKey: Your Google Gemini API key
• openrouterApiKey: Your OpenRouter API key
• openrouterModel: Model id (default: openrouter/auto)

Notes:

• For Gemini, the plugin tries: gemini-2.5-flash, gemini-1.5-flash, gemini-1.5-flash-8b.
• For OpenRouter, the plugin calls https://openrouter.ai/api/v1/chat/completions with a structured prompt and expects JSON { "tags": string[] }.

Usage

1. Open any note in Joplin.
2. Tools → Toggle AI Tag Suggester to open the side panel. Shortcut: Ctrl+Shift+Y (macOS: Cmd+Shift+Y).
3. Click "Suggest Tags". The plugin will analyze the note and return 5 concise, lowercase, hyphenated tags.
4. Click tags to select/deselect, then "Apply" to add them to the note.

Screenshots

AI Tag Suggester side panel opened via Tools → Toggle AI Tag Suggester.

Suggested tags returned by the provider. Click to select/deselect.

Selected tags applied to the current note.

Plugin settings under Tools → Options → AI Tag Suggester.

Development

Build:

npm run build

Pack distributable:

npm run dist

Support

If you find this plugin useful and want to support development:

License

MIT