Description

An AI-powered tag suggestion tool that analyzes note content to recommend relevant tags. Users can select from the suggestions and apply them to their notes, streamlining the organization process.

Additional Information

Links:	View source
Maintainers:	cenktekin
Version:	1.0.5
Minimum app version:	2.10
Downloads: This version:	17
Last updated:	2025-08-23T18:54:51Z

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

1. Build the plugin and pack a .jpl

npm run dist

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