How do I use Zentao MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Zentao MCP Server show me tasks in execution 42" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Zentao MCP Server

by dyno-nexsoft

Overview Schema Related Servers Score Discussions

TypeScript

Remote

Zentao MCP Server

npm version npm downloads GitHub release License Node.js TypeScript MCP Tests

A Model Context Protocol (MCP) server for integrating AI assistants (Claude, Cursor, etc.) with the ZenTao project management API.
Fetch task details, bug reports, and attachments — all directly inside your AI chat.

✨ Features

Tool	Description
`zentao_get_details`	Fetch full details of a task or bug by ID
`zentao_get_comments`	Fetch only the history and comments timeline of a task or bug
`zentao_add_comment`	Add a comment/remark to a task or bug
`zentao_update_task_status`	Update task status (start, finish, close, pause, cancel, restart) and add optional comments/hours
`zentao_update_bug_status`	Update bug status (resolve, close, activate) and add optional comments/resolutions
`zentao_get_assigned_to_me`	Get tasks and bugs currently assigned to you (configured via `ZENTAO_ACCOUNT`)

Under the hood:

🔐 Auto login & token refresh — no manual auth needed
📦 In-memory cache (2 min TTL) + in-flight request dedup — avoids redundant API calls
🔁 Classic JSON API fallback — seamlessly retries via the web API when the REST endpoint returns empty or errors
🖼️ Inline HTML images are automatically downloaded and served as local file:// links
📎 Attachments are downloaded and embedded as clickable local links
🛡️ Corrupt partial downloads are auto-cleaned on error
⚡ Non-blocking async image I/O — base64 encoding uses fs.promises + Promise.all

Related MCP server: Zendesk API MCP Server

📦 Installation

Option 1 — `npx` (recommended, no install required)

npx @dyno181cm.nexsoft/zentao_mcp

Option 2 — Global install

npm install -g @dyno181cm.nexsoft/zentao_mcp
zentao_mcp

Option 3 — Clone & build

git clone https://github.com/dyno-nexsoft/zentao_mcp.git
cd zentao_mcp
npm install
npm run build

⚙️ Configuration

Create a .env file in the project root (or pass via MCP client env block):

ZENTAO_BASE_URL=https://your-zentao-url.com/zentao/api.php/v1
ZENTAO_ACCOUNT=your_username
ZENTAO_PASSWORD=your_password

🔌 MCP Client Integration

This server communicates via stdio transport — compatible with any MCP client.

Claude Desktop / Cursor / Windsurf

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "zentao": {
      "command": "npx",
      "args": ["-y", "@dyno181cm.nexsoft/zentao_mcp"],
      "env": {
        "ZENTAO_BASE_URL": "https://your-zentao-url.com/zentao/api.php/v1",
        "ZENTAO_ACCOUNT": "your_username",
        "ZENTAO_PASSWORD": "your_password"
      }
    }
  }
}

🛠️ Available Tools

`zentao_get_details`

Get full details of a ZenTao task or bug, including repro steps (for bugs), inline images, attachments, history, and comments.

Parameter	Type	Required	Description
`type`	`"task" \| "bug"`	✅	Type of the object
`id`	`string \| number`	✅	Task or Bug ID

`zentao_get_comments`

Get only the history and comments timeline of a task or bug.

Parameter	Type	Required	Description
`type`	`"task" \| "bug"`	✅	Type of the object
`id`	`string \| number`	✅	Task or Bug ID

`zentao_add_comment`

Add a comment/remark to a task or bug.

Parameter	Type	Required	Description
`type`	`"task" \| "bug"`	✅	Type of the object
`id`	`string \| number`	✅	Task or Bug ID
`comment`	`string`	✅	Comment content

`zentao_update_task_status`

Update a task's status with optional comments, actual start/finish dates, and consumed hours.

Parameter	Type	Required	Description
`taskId`	`string \| number`	✅	Task ID
`action`	`"start" \| "finish" \| "close" \| "pause" \| "cancel" \| "restart"`	✅	Status transition action
`comment`	`string`	❌	Optional comment to attach
`consumed`	`number`	❌	Optional hours consumed
`finishedDate`	`string`	❌	Optional actual finish date (YYYY-MM-DD)
`realStarted`	`string`	❌	Optional actual start date (YYYY-MM-DD)
`assignedTo`	`string`	❌	Optional user account to assign to next
`left`	`number`	❌	Optional left hours (for `restart`)

`zentao_update_bug_status`

Update a bug's status with optional comments and resolutions.

Parameter	Type	Required	Description
`bugId`	`string \| number`	✅	Bug ID
`action`	`"resolve" \| "close" \| "activate"`	✅	Status transition action
`comment`	`string`	❌	Optional comment to attach
`resolution`	`"fixed" \| "bydesign" \| "postponed" \| "external" \| "notrepro" \| "willnotfix"`	❌	Optional resolution type
`resolvedBuild`	`string`	❌	Optional build ID where bug was resolved
`resolvedDate`	`string`	❌	Optional resolution date (YYYY-MM-DD)
`assignedTo`	`string`	❌	Optional user account to assign to next
`openedBuild`	`string`	❌	Optional build ID where bug was found (for `activate`)

`zentao_get_assigned_to_me`

Get tasks and bugs currently assigned to the configured user account. Takes no arguments.

🧑‍💻 Development

npm run build      # Compile TypeScript
npm run dev        # Watch mode
npm test           # Unit tests (Jest)
npm run test:api   # Live API integration test

Project structure

src/
├── index.ts                  # MCP server entry point
├── zentaoClient.ts           # Axios client: auth, cache, dedup, fallback, stream helpers
├── tools.ts                  # Thin orchestrator + backward-compat exports
├── utils/
│   ├── fileUtils.ts          # toFileUrl · getMimeType · formatSize
│   ├── markdownUtils.ts      # htmlToMarkdown · parseFiles · formatUser
│   └── mcpResponse.ts        # mcpText · buildMcpResponse (async)
├── formatters/
│   ├── imageLocalizer.ts     # Inline <img> → local file:// link (deduped, concurrent)
│   ├── attachmentRenderer.ts # Attachments → Markdown ## Files section
│   ├── actionFormatter.ts    # renderHistoryAndComments
│   ├── taskFormatter.ts      # taskToMarkdown (includes comments)
│   ├── bugFormatter.ts       # bugToMarkdown (includes comments)
│   └── myWorkFormatter.ts    # myWorkToMarkdown (includes comments)
└── tools/
    ├── detailTool.ts         # zentao_get_details
    ├── commentTool.ts        # zentao_get_comments · zentao_add_comment
    ├── statusTool.ts         # zentao_update_task_status · zentao_update_bug_status
    └── myWorkTool.ts         # zentao_get_assigned_to_me

Running tests

npm test           # Unit tests — 13 tests across ZentaoClient
npm run test:api   # Live API integration test (requires .env)

📄 License

MIT © dyno-nexsoft

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

jiraxmcp
Project Management Developer Tools
vaibhavpandeyvpz
A
license
-
quality
B
maintenance
An MCP server for interacting with Jira Cloud, providing tools for issues, search, agile boards, comments, links, attachments, and webhook notifications.
Last updated 2026-04-28
21
1
MIT
Zendesk API MCP Server
Customer Support Communication
mattcoatsworth
F
license
D
quality
D
maintenance
A comprehensive MCP server for managing Zendesk Support, Talk, Chat, and Guide products, providing tools for tickets, users, organizations, search, and more.
Last updated 2025-04-04
49
28
zentao-mcp-server
Project Management Developer Tools Testing & QA Tools
aipper
A
license
A
quality
B
maintenance
A Model Context Protocol (MCP) server that integrates with Zentao's RESTful API to manage bugs, including listing, resolving, closing, and commenting, with support for product and project set contexts.
Last updated 2026-07-29
11
1,311
MIT
JIRA MCP Server
Project Management Developer Tools
SuppleAardvark
A
license
-
quality
D
maintenance
An MCP server that provides tools to interact with JIRA for sprint management, issue tracking, and attachment handling.
Last updated 2026-01-24
28
MIT

View all related MCP servers

Related MCP Connectors

Azure DevOps (ADO)
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
neverinfamous-memory-journal-mcp
A MCP server built for developers enabling Git based project management with project and personal…
Backtest360
MCP server exposing the Backtest360 engine API as tools for AI agents.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dyno-nexsoft/zentao_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

Zentao MCP Server

✨ Features

📦 Installation

Option 1 — npx (recommended, no install required)

Option 2 — Global install

Option 3 — Clone & build

⚙️ Configuration

🔌 MCP Client Integration

Claude Desktop / Cursor / Windsurf

🛠️ Available Tools

zentao_get_details

zentao_get_comments

zentao_add_comment

zentao_update_task_status

zentao_update_bug_status

zentao_get_assigned_to_me

🧑‍💻 Development

Project structure

Running tests

📄 License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

jiraxmcp

Zendesk API MCP Server

zentao-mcp-server

JIRA MCP Server

Related MCP Connectors

Latest Blog Posts

MCP directory API

Option 1 — `npx` (recommended, no install required)

`zentao_get_details`

`zentao_get_comments`

`zentao_add_comment`

`zentao_update_task_status`

`zentao_update_bug_status`

`zentao_get_assigned_to_me`