# yuque-mcp

Lets an AI assistant read and write your Yuque knowledge base — search docs, create pages, edit book tables of contents.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 257
- Author: yuque
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/yuque/yuque-mcp-server
- Updated: 2026-07-15
- HTML: https://affpapa.org/en/nevibecode/mcp/yuque-mcp

## What it does

The server turns the Yuque API into tools an agent can call. Nineteen of them cover the current user, search, books, docs, tables of contents, notes and boards (mindmaps, flowcharts, diagrams), each tied to a single API route. Search and list calls are paged.

You need a token from Yuque developer settings first. A team token bound to a space also needs that space's host, such as `https://your-space.yuque.com`, passed as `--host` — without it the token won't work. The token goes in `YUQUE_TOKEN` and the host in `YUQUE_HOST`; older names `YUQUE_PERSONAL_TOKEN` and `YUQUE_BASE_URL` still work as fallbacks.

Create and update tools change live content, and the server can do whatever the token allows. Keep it private, and use a space-scoped token when your work stays inside one space. One quirk: `yuque_update_doc` won't take a markdown body together with `title`, `slug` or `public` changes in the same call, so update metadata in a separate request.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `YUQUE_PERSONAL_TOKEN`, `YUQUE_GROUP_TOKEN`, `YUQUE_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add yuque-mcp -e YUQUE_PERSONAL_TOKEN=<YUQUE_PERSONAL_TOKEN> -e YUQUE_GROUP_TOKEN=<YUQUE_GROUP_TOKEN> -e YUQUE_TOKEN=<YUQUE_TOKEN> -- npx -y yuque-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add yuque-mcp --env YUQUE_PERSONAL_TOKEN=<YUQUE_PERSONAL_TOKEN> --env YUQUE_GROUP_TOKEN=<YUQUE_GROUP_TOKEN> --env YUQUE_TOKEN=<YUQUE_TOKEN> -- npx -y yuque-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yuque-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "yuque-mcp"
            ],
            "env": {
                "YUQUE_PERSONAL_TOKEN": "<YUQUE_PERSONAL_TOKEN>",
                "YUQUE_GROUP_TOKEN": "<YUQUE_GROUP_TOKEN>",
                "YUQUE_TOKEN": "<YUQUE_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "yuque-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "yuque-mcp"
            ],
            "env": {
                "YUQUE_PERSONAL_TOKEN": "<YUQUE_PERSONAL_TOKEN>",
                "YUQUE_GROUP_TOKEN": "<YUQUE_GROUP_TOKEN>",
                "YUQUE_TOKEN": "<YUQUE_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e YUQUE_PERSONAL_TOKEN=<YUQUE_PERSONAL_TOKEN> -e YUQUE_GROUP_TOKEN=<YUQUE_GROUP_TOKEN> -e YUQUE_TOKEN=<YUQUE_TOKEN> yuque-mcp npx -y yuque-mcp
```
Replace <…> with your own values

## When to use it
- find everything on canary releases and get a one-page summary
- turn meeting notes into a doc in a chosen book
- add a deployment pipeline diagram to a design doc
- append or move nodes in a book's table of contents
- create and edit notes without opening the browser

## Example prompts
- Search my Yuque for canary release notes and summarize them on one page.
- Move today's meeting notes into a doc in the Tech Research book.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md