English Français العربية

Yuque MCP

Official registry Productivity

Yuque MCP server with safe read/write tools for groups, group members, repositories, docs, and TOC.

Source code Website

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @wwwwwujl/yuque-mcp
Claude Code 
claude mcp add yuque-mcp -e 'YUQUE_TOKEN=<your yuque_token>' -e 'YUQUE_ENDPOINT=<YUQUE_ENDPOINT>' -e 'YUQUE_TIMEOUT_MS=<YUQUE_TIMEOUT_MS>' -e 'YUQUE_MAX_RETRIES=<YUQUE_MAX_RETRIES>' -e 'YUQUE_ALLOW_WRITE=<YUQUE_ALLOW_WRITE>' -e 'YUQUE_WRITE_NAMESPACE_ALLOWLIST=<YUQUE_WRITE_NAMESPACE_ALLOWLIST>' -e 'YUQUE_WRITE_GROUP_ALLOWLIST=<YUQUE_WRITE_GROUP_ALLOWLIST>' -e 'YUQUE_ALLOW_DELETE=<YUQUE_ALLOW_DELETE>' -e 'YUQUE_DELETE_NAMESPACE_ALLOWLIST=<YUQUE_DELETE_NAMESPACE_ALLOWLIST>' -e 'YUQUE_FILE_ROOT=<YUQUE_FILE_ROOT>' -e 'YUQUE_FILE_MAX_BYTES=<YUQUE_FILE_MAX_BYTES>' -e 'YUQUE_FILE_ALLOWED_EXTENSIONS=<YUQUE_FILE_ALLOWED_EXTENSIONS>' -- npx -y @wwwwwujl/yuque-mcp@1.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "yuque-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@wwwwwujl/yuque-mcp@1.1.0"
            ],
            "env": {
                "YUQUE_TOKEN": "<your yuque_token>",
                "YUQUE_ENDPOINT": "<YUQUE_ENDPOINT>",
                "YUQUE_TIMEOUT_MS": "<YUQUE_TIMEOUT_MS>",
                "YUQUE_MAX_RETRIES": "<YUQUE_MAX_RETRIES>",
                "YUQUE_ALLOW_WRITE": "<YUQUE_ALLOW_WRITE>",
                "YUQUE_WRITE_NAMESPACE_ALLOWLIST": "<YUQUE_WRITE_NAMESPACE_ALLOWLIST>",
                "YUQUE_WRITE_GROUP_ALLOWLIST": "<YUQUE_WRITE_GROUP_ALLOWLIST>",
                "YUQUE_ALLOW_DELETE": "<YUQUE_ALLOW_DELETE>",
                "YUQUE_DELETE_NAMESPACE_ALLOWLIST": "<YUQUE_DELETE_NAMESPACE_ALLOWLIST>",
                "YUQUE_FILE_ROOT": "<YUQUE_FILE_ROOT>",
                "YUQUE_FILE_MAX_BYTES": "<YUQUE_FILE_MAX_BYTES>",
                "YUQUE_FILE_ALLOWED_EXTENSIONS": "<YUQUE_FILE_ALLOWED_EXTENSIONS>"
            }
        }
    }
}

Environment variables

  • YUQUE_TOKEN required secret Yuque API token
  • YUQUE_ENDPOINT Yuque API endpoint (optional)
  • YUQUE_TIMEOUT_MS Yuque API timeout in milliseconds (optional)
  • YUQUE_MAX_RETRIES Read-only retry count (optional)
  • YUQUE_ALLOW_WRITE Enable write tools when true (optional, default false)
  • YUQUE_WRITE_NAMESPACE_ALLOWLIST Comma-separated namespace allowlist for repo/doc/toc writes (optional)
  • YUQUE_WRITE_GROUP_ALLOWLIST Comma-separated group login allowlist for group writes (optional)
  • YUQUE_ALLOW_DELETE Enable delete tools when true (optional, default false)
  • YUQUE_DELETE_NAMESPACE_ALLOWLIST Comma-separated delete allowlist targets (optional)
  • YUQUE_FILE_ROOT Allowed root directory for file-based doc tools (optional, default current working directory)
  • YUQUE_FILE_MAX_BYTES Maximum size for file-based doc tools (optional, default 1048576)
  • YUQUE_FILE_ALLOWED_EXTENSIONS Comma-separated allowed extensions for file-based doc tools (optional, default .md,.markdown,.txt)

Frequently asked questions

What is Yuque MCP?

Yuque MCP server with safe read/write tools for groups, group members, repositories, docs, and TOC.

How do I install Yuque MCP?

It runs on your machine. In Claude Code: claude mcp add yuque-mcp -e 'YUQUE_TOKEN=<your yuque_token>' -e 'YUQUE_ENDPOINT=<YUQUE_ENDPOINT>' -e 'YUQUE_TIMEOUT_MS=<YUQUE_TIMEOUT_MS>' -e 'YUQUE_MAX_RETRIES=<YUQUE_MAX_RETRIES>' -e 'YUQUE_ALLOW_WRITE=<YUQUE_ALLOW_WRITE>' -e 'YUQUE_WRITE_NAMESPACE_ALLOWLIST=<YUQUE_WRITE_NAMESPACE_ALLOWLIST>' -e 'YUQUE_WRITE_GROUP_ALLOWLIST=<YUQUE_WRITE_GROUP_ALLOWLIST>' -e 'YUQUE_ALLOW_DELETE=<YUQUE_ALLOW_DELETE>' -e 'YUQUE_DELETE_NAMESPACE_ALLOWLIST=<YUQUE_DELETE_NAMESPACE_ALLOWLIST>' -e 'YUQUE_FILE_ROOT=<YUQUE_FILE_ROOT>' -e 'YUQUE_FILE_MAX_BYTES=<YUQUE_FILE_MAX_BYTES>' -e 'YUQUE_FILE_ALLOWED_EXTENSIONS=<YUQUE_FILE_ALLOWED_EXTENSIONS>' -- npx -y @wwwwwujl/yuque-mcp@1.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Yuque MCP need an API key?

Yes. It expects YUQUE_TOKEN, which you set in its configuration.

Is Yuque MCP open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Yuque MCP?

It is published by wwwwujl. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.