clickup-rich-comments
Your ClickUp MCP posts ## broken comments. This fixes them.
Auto-upgrades every agent comment to native rich text — headers, bold, lists, code.
Works with Claude Code and Cursor.

This repo ships a post-hook plus an optional skill/plugin named clickup-comment-style (the install id in /plugin install ...).

The problem
Your agent writes a nicely formatted comment:
## Deploy steps
1. Run `migrate`
2. Restart the worker
ClickUp shows your team this — raw, unrendered:
## Deploy steps
1. Run `migrate`
2. Restart the worker
Same text. The ## and 1. never render: the MCP only writes plain comment_text, and ClickUp doesn't parse Markdown there.
What renders / what doesn't
In comment_text | Renders in ClickUp UI? |
|---|
Inline code `identifier` | Yes |
Raw URL https://... | Yes (auto-link) |
**bold**, *italic*, ~~strike~~ | No — literal |
[text](url) | No — literal |
## headers, - bullets, 1. lists | No — literal |
> blockquote, ``` fences | No — literal |
Quickstart
git clone https://github.com/TaricaTarica/clickup-rich-comments.git
cd clickup-rich-comments
./install.sh
The installer checks prerequisites, guides you through CLICKUP_API_TOKEN setup, and configures hooks for Cursor and Claude Code automatically. Takes about two minutes.
Requirements: python3, jq (for hook wrappers). No pip packages.
Install
⚠️ Pick one install method. If you install a plugin, don't also run ./install.sh
(or merge hooks manually) — you'd run the upgrade twice per comment.
Install as a Cursor plugin — recommended for Cursor users
Install the hook and style guide in one step via the Cursor plugin marketplace:
/plugin marketplace add TaricaTarica/clickup-rich-comments
Then in a Cursor session:
/plugin install clickup-comment-style@clickup-rich-comments
Or use /add-plugin and search for clickup-comment-style.
After install, restart Cursor or run Developer: Reload Window. Hook changes are not hot-reloaded; SKILL.md and rule updates may require a reload.
Requirements: python3, jq, and CLICKUP_API_TOKEN in your environment (see token setup). The plugin installs the mechanism only — it never embeds or ships credentials.
What you get: an afterMCPExecution hook that upgrades clickup_create_task_comment output to native rich text, plus the comment style guide skill and rule.
ClickUp MCP: must already be configured separately. This plugin does not declare mcp.json — adding ClickUp MCP again would conflict with your existing setup.
Marketplace source: add the marketplace via Git shorthand (owner/repo) or a git URL. Do not add it via a direct URL to marketplace.json — relative plugin paths (./plugin-cursor) only resolve when the marketplace is fetched from a git repository.
Test locally before publishing:
ln -sf "$(pwd)/plugin-cursor" ~/.cursor/plugins/local/clickup-comment-style
# Developer: Reload Window → verify rules, skills, and hooks in Settings
If symlinks are missing after clone (common on Windows), run ./scripts/sync-plugins.sh.
Install as a Claude Code plugin — recommended for Claude Code users
For Claude Code, install the hook and style guide in one step via the plugin marketplace:
claude plugin marketplace add TaricaTarica/clickup-rich-comments
Then in a Claude Code session:
/plugin install clickup-comment-style@clickup-rich-comments
After install, restart the session or run /reload-plugins. Hook changes are not hot-reloaded; SKILL.md updates are.
Requirements: python3, jq, and CLICKUP_API_TOKEN in your environment (see token setup). The plugin installs the mechanism only — it never embeds or ships credentials.