The ZenTao MCP Server is a CLI tool that provides programmatic integration with ZenTao project management software to manage and query products and bugs.
List Products: Retrieve all products with details like ID, name, and bug counts, with pagination support using
zentao_products_list.List Bugs by Product: View bugs for a specific product by providing the product ID with
zentao_bugs_list.Get Bug Details: Fetch comprehensive details about a specific bug using its ID with
zentao_bug_get.List My Bugs: Access a personalized list of bugs assigned to or created by you with flexible filtering options including scope (assigned/opened/resolved/all), status (active/resolved/closed/all), product ID, account, pagination controls, and optional full details using
zentao_bugs_mine.Authentication: Configure credentials via CLI arguments, environment variables, or saved login for seamless access without re-authentication.
Bilingual Support: Handles queries in both English and Chinese for common bug-related operations.
JSON Output: Commands support full JSON output for programmatic use.
Self-Test: Verify configuration and connectivity with a diagnostic self-test command.
Local Development: Includes tools for testing and development workflows.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ZenTao MCP Servershow me bugs assigned to me"
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
ZenTao CLI for products + bugs.
Installation
Global install (recommended):
pnpm i -g @leeguoo/zentao-mcpIf you don't have pnpm:
npm i -g pnpm
pnpm i -g @leeguoo/zentao-mcpOr use without installing:
npx -y @leeguoo/zentao-mcp --helpThis installs the zentao command (and keeps zentao-mcp as a compatibility alias).
Configuration
Required Parameters
You can configure the CLI using CLI arguments or environment variables:
CLI arguments:
--zentao-url(e.g.https://zentao.example.com/zentao)--zentao-account--zentao-password
Environment variables:
ZENTAO_URLZENTAO_ACCOUNTZENTAO_PASSWORD
Tip: ZENTAO_URL should include the ZenTao base path (often /zentao).
Example:
https://zentao.example.com/zentao(common)
If you see 404 Not Found when logging in, your base path is likely missing /zentao.
Commands
List products:
zentao products listFull JSON output:
zentao products list --jsonList bugs for a product:
zentao bugs list --product 1Full JSON output:
zentao bugs list --product 1 --jsonGet bug details:
zentao bug get --id 123Full JSON output:
zentao bug get --id 123 --jsonList my bugs:
zentao bugs mine --scope assigned --status activeFull JSON output:
zentao bugs mine --scope assigned --status active --jsonSelf test:
zentao self-testLogin
Save credentials locally (stored as plaintext TOML under your user config directory):
zentao login --zentao-url=https://zentao.example.com/zentao --zentao-account=leo --zentao-password=***Config file:
~/.config/zentao/config.toml(or$XDG_CONFIG_HOME/zentao/config.toml)
Then commands can omit auth flags:
zentao whoami
zentao products listTroubleshooting login:
If
Token response parse failed: <html>...404 Not Found..., try:https://your-host/zentaoinstead ofhttps://your-host/
Release (maintainers)
GitHub Actions (recommended)
This repo supports npm Trusted Publisher (OIDC) via GitHub Actions.
Create a tag matching
package.jsonversion:
git tag v0.5.1
git push origin v0.5.1The workflow
.github/workflows/publish-npm.ymlwill run tests and publish to npm.
In npm Trusted Publisher settings, set the workflow filename to publish-npm.yml.
Local release (fallback)
Requires git, npm, and gh.
zentao release patch --dry-runIf you are using GitHub Actions publishing, prefer tagging + pushing, or run local release with:
zentao release patch --skip-publishLocal Development
pnpm install
pnpm testSecurity
Do not commit credentials. Prefer environment variables in local runs.
Skill
For OpenClaw (AgentSkills-compatible), see skills/zentao/SKILL.md.