# Adding html\_text parameter to asana\_create\_task\_story MCP tool for rich text comments

**URL:** <https://forum.asana.com/t/adding-html-text-parameter-to-asana-create-task-story-mcp-tool-for-rich-text-comments/1126181>\
**Category:** Product Ideas\
**Tags:** agentic-work-management\
**Created:** [18 February 2026 17:00 UTC](https://forum.asana.com/t/adding-html-text-parameter-to-asana-create-task-story-mcp-tool-for-rich-text-comments/1126181 "2026-02-18T17:00:02Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![FloopCZE](https://luna1.co/8d76cd.png) [@FloopCZE](https://forum.asana.com/u/FloopCZE)\
**Post date:** [18 February 2026 17:00 UTC](https://forum.asana.com/t/adding-html-text-parameter-to-asana-create-task-story-mcp-tool-for-rich-text-comments/1126181/1 "2026-02-18T17:00:02Z")

</div>

Hi Asana MCP team,

We would like to request the addition of an `html_text` parameter to the `asana_create_task_story` tool in the Asana MCP server.

**What is missing:**

Currently, the `asana_create_task_story` tool only exposes the `text` parameter for creating comments (stories) on tasks. The Asana REST API, however, supports two fields for this purpose:

- `text` — plain text, no formatting

- `html_text` — HTML-formatted rich text (supports `<strong>`, `<code>`, `<em>`, `<ul>`, `<ol>`, `<a>`, etc.)

Since only `text` is available through the MCP, there is no way to post rich-text-formatted comments. Markdown syntax (e.g., ` **bold** `, ``code``) is rendered as literal characters, and HTML tags (e.g., `<strong>bold</strong>`) are escaped by the API and displayed as plain text.

**Why we need this:**

We use AI agents (via MCP clients like Cursor, Claude Desktop, etc.) to automate workflows that involve posting structured, readable comments on Asana tasks — such as investigation summaries, status updates, code review notes, and technical reports. These comments often contain code snippets, bold headings, lists, and links. Without rich text support, the comments are difficult to read and lack the structure needed to be useful.

We note that other MCP tools already support HTML-formatted text — for example, `asana_create_task` and `asana_update_task` both expose `html_notes` for task descriptions, and `asana_create_project_status` supports `html_text` for project status updates. The inconsistency means comments are the only major text area where rich formatting is unavailable through the MCP.

**Suggested implementation:**

Add an optional `html_text` parameter to the `asana_create_task_story` tool, analogous to how `html_notes` works for tasks. When `html_text` is provided, it would be passed to the Asana REST API’s `html_text` field for the story creation endpoint. The existing `text` parameter would remain as a fallback for plain text comments.

We believe this would be a straightforward addition given that the underlying REST API already supports `html_text` for stories, and the pattern is already established in other MCP tools.

Thank you for considering this request — and thank you for the excellent MCP server overall. It has been a great productivity boost for our team!

---

<div class="post-metadata">

**Author:** ![Phil\_Seeman](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/phil_seeman/32/81525_2.png) [@Phil\_Seeman](https://forum.asana.com/u/Phil_Seeman)\
**Post date:** [20 February 2026 07:25 UTC](https://forum.asana.com/t/adding-html-text-parameter-to-asana-create-task-story-mcp-tool-for-rich-text-comments/1126181/2 "2026-02-20T07:25:51Z")

</div>

cc: @Dominik_Brdak @John_Baldo

---

<div class="post-metadata">

**Author:** ![Dominik\_Brdak](https://sea2.discourse-cdn.com/asana/user_avatar/forum.asana.com/dominik_brdak/32/281949_2.png) [@Dominik\_Brdak](https://forum.asana.com/u/Dominik_Brdak)\
**Post date:** [3 March 2026 14:47 UTC](https://forum.asana.com/t/adding-html-text-parameter-to-asana-create-task-story-mcp-tool-for-rich-text-comments/1126181/3 "2026-03-03T14:47:20Z")

</div>

Hi @FloopCZE!

Thank you for the thoughtful feedback—I completely agree with you. If LLMs could leverage the `html_text` field, that would indeed unlock some very powerful use cases.

With the release of v2, we intentionally reduced the overall number of available tools (nearly by half). As part of that change, the `asana_create_task_story` tool is no longer included. We shared the reasoning behind this in the [v2 changelog](https://forum.asana.com/t/new-v2-mcp-server-now-generally-available/1122647#p-2227543-optimized-tool-set-6), but in short: we chose to prioritize quality over quantity. The goal is to ensure that the tools we do expose are well-scoped, reliable, and supported by strong, contextual instructions so agents can use them effectively.

That said, this is a temporary limitation. We’re actively evaluating which tools should be reintroduced or added next, based on real-world needs and feedback like yours. While this means LLMs may feel a bit more constrained right now, the intention is for them to perform actions more accurately and with better context.

I agree that adding a `create_task_story` tool could unblock many workflows and improve how agents interact with Asana. I’ll pass your feedback along to our R&D team so they can evaluate the request and consider next steps.

Thanks again for sharing your perspective! I’ll follow up if we have any questions on our end.

Best,  
Dominik

---

<div class="post-metadata">

**Author:** ![Jeff\_Schwane](https://luna1.co/8d76cd.png) [@Jeff\_Schwane](https://forum.asana.com/u/Jeff_Schwane)\
**Post date:** [8 April 2026 12:57 UTC](https://forum.asana.com/t/adding-html-text-parameter-to-asana-create-task-story-mcp-tool-for-rich-text-comments/1126181/4 "2026-04-08T12:57:41Z")

</div>

I have the same use case, and also need to create stories with rich html text from an agent. I would very much appreciate if you could add this to the v2 MCP. 😃
