zentao-mcp

Check bugs, tasks, requirements, to-dos, products, projects, tests, and documents from the command line, allowing your AI assistant to interact directly with ZenTao.

Zero dependencies, single file, ready to use after installation.

Quick Start

npx skills add leeguooooo/zentao-mcp -y -g

Install CLI:

pnpm i -g @leeguoo/zentao-mcp

No pnpm? You can also use npm:

npm i -g @leeguoo/zentao-mcp

Don't want to install? Run directly:

npx -y @leeguoo/zentao-mcp --help

skills add is only responsible for installing the skill file; it is still recommended to install the CLI globally and use the zentao command directly.

Related MCP server: ZenTao Bugs MCP Server

Login

Log in just once, and credentials will be saved to a local configuration file:

zentao login \
  --zentao-url=https://zentao.example.com/zentao \
  --zentao-account=你的账号 \
  --zentao-password=你的密码

Note: The URL usually needs to include the /zentao path. If you see a 404 when logging in, it is likely missing.

Verify login status:

zentao whoami

Configuration file location: ~/.config/zentao/config.toml

Supported Capabilities

The current CLI supports these objects and actions:

• Authentication and Connectivity: login, whoami, self-test

• Bugs: list, query, create, assign, comment, resolve, close, activate, check my bugs

• Tasks: list, query, create, start, finish, pause, close

• Requirements: list, query, create

• To-dos: list, query, create, finish, close

• Products / Projects / Programs / Executions: list, project build query

• Plans / Releases: list, details

• Test Cases / Test Runs / Test Suites: list, details

• Document Libraries / Documents: list, details

• Users / Departments: list

• Issues / Risks: list, details

• Machine-readable output: All commands support --json

Daily Usage

View Product List

zentao products list

View Bugs for a Specific Product

zentao bugs list --product 6

View Bug Details

zentao bug get --id 1329

View Bugs Assigned to Me

zentao bugs mine --status active

With details:

zentao bugs mine --status active --include-details

Need Raw JSON?

Add --json after any command:

zentao products list --json
zentao bugs list --product 6 --json
zentao bug get --id 1329 --json
zentao bugs mine --include-details --json

Self-Test

Verify if the API connection is normal:

zentao self-test

Command Overview

zentao login --zentao-url=... --zentao-account=... --zentao-password=...
zentao whoami
zentao self-test

zentao products list
zentao programs list
zentao projects list
zentao projects builds --id 22
zentao executions list

zentao bugs list --product 6
zentao bugs mine --status active --include-details
zentao bug get --id 1329
zentao bug create --product 6 --title "bug title"
zentao bug assign --id 1329 --assigned-to someone
zentao bug resolve --id 1329 --resolution fixed
zentao bug close --id 1329
zentao bug activate --id 1329
zentao bug comment --id 1329 --comment "comment"

zentao tasks list --execution 25
zentao task get --id 388
zentao task create --execution 25 --name "task name"
zentao task start --id 388
zentao task finish --id 388
zentao task pause --id 388
zentao task close --id 388

zentao stories list --product 3
zentao story get --id 1
zentao story create --product 3 --title "story title"

zentao todos list
zentao todos get --id 1
zentao todos create --name "todo name"
zentao todos finish --id 1
zentao todos close --id 1

zentao plans list --product 3
zentao plans get --id 1
zentao releases list --product 3
zentao releases get --id 1

zentao testcases list --product 3
zentao testcases get --id 1
zentao testtasks list
zentao testtasks get --id 1
zentao testsuites list --product 3
zentao testsuites get --id 1

zentao docs libs
zentao docs list --lib 50
zentao docs get --id 1
zentao users list
zentao departments list
zentao issues list
zentao issues get --id 1
zentao risks list
zentao risks get --id 1

Let AI Help You Check ZenTao

Just say to your AI assistant (Cursor / Claude Code / Windsurf, etc.):

Help me execute npx skills add leeguooooo/zentao-mcp -y -g, then help me log in to ZenTao

After installation, you can directly say:

• "Help me see which unresolved bugs are in product 6"

• "Check the details of bug #1329"

• "How many active bugs do I have?"

• "Help me see what tasks are in execution 25"

• "Check the requirements / plans / releases for product 3"

• "List test runs, test cases, and test suites"

• "Look at project issues and risks"

• "Open the document list in document library 50"

When a user requests to install this repository as a skill, please execute in order:

1. Install Skill

npx skills add leeguooooo/zentao-mcp -y -g

2. Install CLI

pnpm i -g @leeguoo/zentao-mcp || npm i -g @leeguoo/zentao-mcp

3. Verify Installation

zentao --help

4. Guide Login

Prompt the user to provide the ZenTao URL, account, and password, then execute:

zentao login --zentao-url="<用户的禅道URL>" --zentao-account="<账号>" --zentao-password="<密码>"

Note: The URL usually needs to include /zentao, such as https://zentao.example.com/zentao

5. Verify

zentao whoami
zentao self-test

After everything passes, inform the user that the installation is complete.

FAQ

Q: 404 error when logging in? A: The URL needs to include /zentao, for example https://zentao.example.com/zentao, not https://zentao.example.com/.

Q: Which ZenTao versions are supported? A: Supports ZenTao Open Source and Enterprise versions' REST API (v1).

Q: Are credentials secure? A: Credentials are stored in plain text TOML in ~/.config/zentao/config.toml. Please ensure file permissions are secure. Do not commit the configuration file to Git.

Links

• npm

• GitHub

• Issue Feedback