# Aliyun Yunxiao Projex MCP

> Aliyun Yunxiao Projex MCP is an open-source MCP server for productivity. Stdio MCP server for Alibaba Cloud Yunxiao Projex work items, sprints and comments. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/mrlinwang/yunxiao-projex-mcp
- **MCP Registry name:** io.github.MrLinWang/aliyun-yunxiao-projex-mcp
- **Categories:** [productivity](https://ai-powered.com/categories/productivity), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-15

## About

This Python server wraps the Yunxiao Projex OpenAPI and is pinned to a single project, set by an environment variable, so its tools cannot reach any other project. It signs in with a Yunxiao bot AccessKey, runs over stdio and is started with uvx from PyPI.

Work items can be listed, read, created, updated and deleted; comments and sprints are covered too. The server can work out which work items belong to the AccessKey's own user, and its isMine flag appears on list and get results. It also downloads attached files and images with the bot's credentials, returning images inline and other files as base64 up to 10 MiB, or saving them to disk.

The README is in Chinese and English. It notes limits: the bot role cannot edit project fields or members, and time estimates, attachment uploads, work item links, code repositories and pipelines are out of scope. Deletes require confirm=true. An agent skill in the repository adds status-sync conventions.

## Features

- **Project-scoped tools:** Every tool acts only on the project ID you configure.
- **Work item CRUD:** List, read, create, update and delete work items.
- **Self-assignee detection:** Finds items assigned to the AccessKey user via assigned_to_me and isMine.
- **Authenticated downloads:** Fetches work item attachments and images, with optional save-to-disk.
- **Comments and sprints:** Create comments and sprints, and read members and statuses.
- **Guarded deletes:** Deleting items and comments requires confirm=true.

## Good for

- Have an agent triage the sprint backlog in Yunxiao
- Create a work item with required custom fields
- Post a pull request link as a comment on the linked work item
- Download an attached screenshot from a work item
- List only the work items assigned to the bot

## Install

### Claude Code (Terminal)

```sh
claude mcp add aliyun-yunxiao-projex-mcp --env YUNXIAO_USER_ACCESS_KEY_ID='<YUNXIAO_USER_ACCESS_KEY_ID>' --env YUNXIAO_USER_ACCESS_KEY_SECRET='<YUNXIAO_USER_ACCESS_KEY_SECRET>' --env YUNXIAO_API_ORG_ID='<YUNXIAO_API_ORG_ID>' --env YUNXIAO_API_PROJECT_ID='<YUNXIAO_API_PROJECT_ID>' -- uvx yunxiao-projex-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "aliyun-yunxiao-projex-mcp": {
      "command": "uvx",
      "args": [
        "yunxiao-projex-mcp"
      ],
      "env": {
        "YUNXIAO_USER_ACCESS_KEY_ID": "<YUNXIAO_USER_ACCESS_KEY_ID>",
        "YUNXIAO_USER_ACCESS_KEY_SECRET": "<YUNXIAO_USER_ACCESS_KEY_SECRET>",
        "YUNXIAO_API_ORG_ID": "<YUNXIAO_API_ORG_ID>",
        "YUNXIAO_API_PROJECT_ID": "<YUNXIAO_API_PROJECT_ID>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "aliyun-yunxiao-projex-mcp": {
      "command": "uvx",
      "args": [
        "yunxiao-projex-mcp"
      ],
      "env": {
        "YUNXIAO_USER_ACCESS_KEY_ID": "<YUNXIAO_USER_ACCESS_KEY_ID>",
        "YUNXIAO_USER_ACCESS_KEY_SECRET": "<YUNXIAO_USER_ACCESS_KEY_SECRET>",
        "YUNXIAO_API_ORG_ID": "<YUNXIAO_API_ORG_ID>",
        "YUNXIAO_API_PROJECT_ID": "<YUNXIAO_API_PROJECT_ID>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "aliyun-yunxiao-projex-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "yunxiao-projex-mcp"
      ],
      "env": {
        "YUNXIAO_USER_ACCESS_KEY_ID": "<YUNXIAO_USER_ACCESS_KEY_ID>",
        "YUNXIAO_USER_ACCESS_KEY_SECRET": "<YUNXIAO_USER_ACCESS_KEY_SECRET>",
        "YUNXIAO_API_ORG_ID": "<YUNXIAO_API_ORG_ID>",
        "YUNXIAO_API_PROJECT_ID": "<YUNXIAO_API_PROJECT_ID>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "aliyun-yunxiao-projex-mcp": {
      "command": "uvx",
      "args": [
        "yunxiao-projex-mcp"
      ],
      "env": {
        "YUNXIAO_USER_ACCESS_KEY_ID": "<YUNXIAO_USER_ACCESS_KEY_ID>",
        "YUNXIAO_USER_ACCESS_KEY_SECRET": "<YUNXIAO_USER_ACCESS_KEY_SECRET>",
        "YUNXIAO_API_ORG_ID": "<YUNXIAO_API_ORG_ID>",
        "YUNXIAO_API_PROJECT_ID": "<YUNXIAO_API_PROJECT_ID>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "aliyun-yunxiao-projex-mcp": {
      "command": "uvx",
      "args": [
        "yunxiao-projex-mcp"
      ],
      "env": {
        "YUNXIAO_USER_ACCESS_KEY_ID": "<YUNXIAO_USER_ACCESS_KEY_ID>",
        "YUNXIAO_USER_ACCESS_KEY_SECRET": "<YUNXIAO_USER_ACCESS_KEY_SECRET>",
        "YUNXIAO_API_ORG_ID": "<YUNXIAO_API_ORG_ID>",
        "YUNXIAO_API_PROJECT_ID": "<YUNXIAO_API_PROJECT_ID>"
      }
    }
  }
}
```

## Tools

- `get_project`: Read-only Yunxiao Projex tool.
- `get_current_user`: Read-only Yunxiao Projex tool.
- `list_project_members`: Read-only Yunxiao Projex tool.
- `list_workitem_types`: Read-only Yunxiao Projex tool.
- `list_workitem_fields`: Read-only Yunxiao Projex tool.
- `list_workitem_statuses`: Read-only Yunxiao Projex tool.
- `list_workitems`: Read-only Yunxiao Projex tool.
- `get_workitem`: Read-only Yunxiao Projex tool.
- `get_workitem_file`: Read-only Yunxiao Projex tool.
- `list_workitem_comments`: Read-only Yunxiao Projex tool.
- `list_sprints`: Read-only Yunxiao Projex tool.
- `get_sprint`: Read-only Yunxiao Projex tool.
- `create_workitem`: Write tool for Yunxiao Projex.
- `update_workitem`: Write tool for Yunxiao Projex.
- `create_workitem_comment`: Write tool for Yunxiao Projex.
- `update_workitem_comment`: Write tool for Yunxiao Projex.
- `create_sprint`: Write tool for Yunxiao Projex.
- `delete_workitem`: Delete tool; requires confirm=true.
- `delete_workitem_comment`: Delete tool; requires confirm=true.

## FAQ

### How do I run it?

Run uvx yunxiao-projex-mcp, with the organisation ID, project ID and bot AccessKey set as environment variables.

### Can it touch other projects?

No. All tools are fixed to the configured project.

### What is it not able to do?

It has no time tracking, attachment upload, work item links, project creation, code repositories or pipelines.

### What is the licence?

MIT.

### Is Aliyun Yunxiao Projex MCP free?

Yes. Aliyun Yunxiao Projex MCP is open source, so you can use and self-host it for free.

### How do I add Aliyun Yunxiao Projex MCP to Claude Code?

Run this command in your terminal: claude mcp add aliyun-yunxiao-projex-mcp --env YUNXIAO_USER_ACCESS_KEY_ID='<YUNXIAO_USER_ACCESS_KEY_ID>' --env YUNXIAO_USER_ACCESS_KEY_SECRET='<YUNXIAO_USER_ACCESS_KEY_SECRET>' --env YUNXIAO_API_ORG_ID='<YUNXIAO_API_ORG_ID>' --env YUNXIAO_API_PROJECT_ID='<YUNXIAO_API_PROJECT_ID>' -- uvx yunxiao-projex-mcp

### What are the best alternatives to Aliyun Yunxiao Projex MCP?

The closest alternatives to Aliyun Yunxiao Projex MCP are Atlassian Extended, Orangescrum MCP Server, Nusk, Yandex Tracker MCP and Monday Com.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Atlassian Extended](https://ai-powered.com/mcp/atlassian-extended): Atlassian Extended is an open-source MCP server for developer tools.
- [Orangescrum MCP Server](https://ai-powered.com/mcp/orangescrum-mcp-server): Orangescrum MCP Server is an MCP server for productivity.
- [Nusk](https://ai-powered.com/mcp/nusk): Nusk is an MCP server for productivity.
- [Yandex Tracker MCP](https://ai-powered.com/mcp/yandex-tracker-mcp): Yandex Tracker MCP is an open-source MCP server for developer tools.
- [Monday Com](https://ai-powered.com/mcp/monday-com): Monday Com is an open-source MCP server for productivity.
- [Huly MCP Selfhost](https://ai-powered.com/mcp/huly-mcp-selfhost): Huly MCP Selfhost is an MCP server for productivity.
- [Atalaya](https://ai-powered.com/mcp/atalaya): Atalaya is a free MCP server for productivity.
- [Kaiku](https://ai-powered.com/mcp/kaiku): Kaiku is an MCP server for productivity.

---
Source: https://ai-powered.com/mcp/aliyun-yunxiao-projex-mcp
