Skip to content

Repository files navigation

ClickUp AI — Obsidian Plugin

An Obsidian plugin with a dual-panel sidebar: a live ClickUp task board and a context-aware AI chat. Create tasks, normalize messy notes into structured ## Context / ## Tasks format, and chat with an AI that has access to your current Obsidian note — all without leaving the editor.

Task panel

Features

  • ClickUp task panel — browse workspaces, spaces, folders, and lists; create tasks with priority, due date, and comments directly from Obsidian
  • AI chat — multi-provider chat (Gemini, Claude, GPT) with your current note as context
  • Note normalize — convert any freeform note into structured ## Context / ## Tasks markdown with one click; supports text, images, PDFs, and canvas files
  • Multi-provider — Gemini (free tier available), Claude (Anthropic), and OpenAI; switch models per session
  • Chat history — conversations auto-saved to your vault as Markdown files
  • Vision support — attach images and PDFs directly in chat

Screenshots

AI chat Normalize Settings

Tech Stack

  • TypeScript / JavaScript (Obsidian Plugin API)
  • ClickUp REST API v2
  • Anthropic Messages API · Google Gemini API · OpenAI Chat Completions API

Installation

This plugin is not yet on the Obsidian Community Plugins marketplace. Install manually:

  1. Download the latest release (or clone this repo)
  2. Copy main.js and manifest.json into your vault's plugin folder:
    <your-vault>/.obsidian/plugins/clickup-ai/
    
  3. In Obsidian: Settings → Community Plugins → Installed Plugins → enable ClickUp AI
  4. Open plugin settings and enter your API keys

Setup

Open Settings → ClickUp AI and fill in:

Field Where to get it
ClickUp API Key ClickUp Settings → Apps
Gemini API Key Google AI Studio
Claude API Key Anthropic Console
OpenAI API Key OpenAI Platform

You only need the API keys for the providers you intend to use. Gemini has a free tier that works for most normalize and chat tasks.

After saving, select your default workspace, space, folder, and list — the task panel will load automatically.

Usage

Task panel — click the ClickUp icon in the left sidebar. Browse your lists, click a task to expand it, or use the + New Task button.

AI chat — click the chat icon in the sidebar. The current note's content is automatically injected as context. Attach files via the paperclip icon.

Normalize — open a note, run the command ClickUp AI: Normalize note from the command palette. The note is rewritten in place into ## Context / ## Tasks format.

Security

API keys are stored in Obsidian's native settings system (data.json inside the plugin folder). They are never committed to this repository — the source code only references them via the settings object at runtime.

Status

Active — used daily as a personal productivity tool. v2.0.20.

Issues and PRs welcome.

License

MIT

About

full Obsidian plugin that embeds ClickUp directly into your workflow. It adds a dual‑tab panel: Tasks (your full ClickUp hierarchy as interactive cards) and AI (a Claude‑powered chat with note‑aware context). Build, browse, and manage tasks without leaving Obsidian. Developed through a phase‑tracked process with a live ClickUp changelog.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages