Yuque MCP
Connects Claude to Yuque's knowledge base platform with full CRUD operations across groups, repositories, and documents. You get read tools for browsing repos and fetching markdown content, write tools for creating and updating docs (including from local files), and TOC management for organizing content hierarchies. Ships with granular safety controls: writes are off by default, deletes require explicit confirmation text, and you can allowlist specific namespaces or groups. Useful when you want Claude to treat your Yuque workspace as a living knowledge base it can both query and maintain, or when building documentation workflows that need programmatic access to Yuque's API without writing your own client.
- tools
- 14
- auth
- Secret needed
- transport
- STDIO
- env vars
- 12
- last updated
- Feb 18, 2026
Tools
14 toolsPublic tool metadata for what this MCP can expose to an agent.
yuque_get_docReads a doc by slug or doc_id, with support for markdown/raw content.
Reads a doc by slug or doc_id, with support for markdown/raw content.
No parameter schema in public metadata yet.
yuque_update_docUpdates a doc, accepting either slug or doc_id.
Updates a doc, accepting either slug or doc_id.
No parameter schema in public metadata yet.
yuque_delete_docDeletes a doc, accepting either slug or doc_id, guarded by delete safety settings.
Deletes a doc, accepting either slug or doc_id, guarded by delete safety settings.
No parameter schema in public metadata yet.
yuque_list_docsLists docs in a repository with pagination (offset, limit).
Lists docs in a repository with pagination (offset, limit).
No parameter schema in public metadata yet.
yuque_search_docsSearches docs across the full repository by scanning paginated docs.
Searches docs across the full repository by scanning paginated docs.
No parameter schema in public metadata yet.
yuque_list_group_usersLists members of a group.
Lists members of a group.
No parameter schema in public metadata yet.
yuque_add_group_userAdds a member to a group.
Adds a member to a group.
No parameter schema in public metadata yet.
yuque_remove_group_userRemoves a member from a group.
Removes a member from a group.
No parameter schema in public metadata yet.
yuque_delete_repoDeletes a repository (knowledge base), guarded by delete safety settings.
Deletes a repository (knowledge base), guarded by delete safety settings.
No parameter schema in public metadata yet.
yuque_delete_groupDeletes a group, guarded by delete safety settings.
Deletes a group, guarded by delete safety settings.
No parameter schema in public metadata yet.
get_my_repositoriesCombined operation that lists the user's repositories.
Combined operation that lists the user's repositories.
No parameter schema in public metadata yet.
get_repository_overviewCombined operation that returns an overview of a repository.
Combined operation that returns an overview of a repository.
No parameter schema in public metadata yet.
search_and_readCombined operation that searches docs and reads matching content.
Combined operation that searches docs and reads matching content.
No parameter schema in public metadata yet.
create_document_with_tocCombined operation that creates a document and updates the repository TOC.
Combined operation that creates a document and updates the repository TOC.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
YUQUE_TOKEN*secretYuque API token
YUQUE_ENDPOINTYuque API endpoint (optional)
YUQUE_TIMEOUT_MSYuque API timeout in milliseconds (optional)
YUQUE_MAX_RETRIESRead-only retry count (optional)
YUQUE_ALLOW_WRITEEnable write tools when true (optional, default false)
YUQUE_WRITE_NAMESPACE_ALLOWLISTComma-separated namespace allowlist for repo/doc/toc writes (optional)
YUQUE_WRITE_GROUP_ALLOWLISTComma-separated group login allowlist for group writes (optional)
YUQUE_ALLOW_DELETEEnable delete tools when true (optional, default false)
YUQUE_DELETE_NAMESPACE_ALLOWLISTComma-separated delete allowlist targets (optional)
YUQUE_FILE_ROOTAllowed root directory for file-based doc tools (optional, default current working directory)
YUQUE_FILE_MAX_BYTESMaximum size for file-based doc tools (optional, default 1048576)
YUQUE_FILE_ALLOWED_EXTENSIONSComma-separated allowed extensions for file-based doc tools (optional, default .md,.markdown,.txt)
Readme
yuque-mcp
中文说明: README.zh-CN.md
This folder is prepared for building a custom MCP server for Yuque.
Goal
Build a Yuque MCP server so Codex can:
- discover Yuque repos and docs
- read doc content in markdown/raw mode
- create/update/delete docs when needed
- create docs from local files and update docs from local files
- create/update/delete repos (knowledge bases)
- create/update/delete groups
- manage group members (
list/add/remove) - run combined operations (
get_my_repositories,get_repository_overview,search_and_read,create_document_with_toc) - update repository TOC nodes
- use Yuque content as a research knowledge base
Included Docs
docs/00-project-brief.mddocs/01-scope-v1.mddocs/02-architecture.mddocs/03-tool-contract.mddocs/04-api-mapping.mddocs/05-security.mddocs/06-implementation-plan.mddocs/07-test-plan.mddocs/08-codex-integration.mddocs/09-release-notes-zh.mddocs/10-registry-publish.mddocs/11-weekly-maintenance.mddocs/12-complaint-and-takedown.mdCHANGELOG.mdCONTRIBUTING.mdSECURITY.mdDISCLAIMER.mdtasks/TODO.md
Session Kickoff
Details
- Repository
- github.com/wwwwujl/yuque-mcp
- Website
- github.com/wwwwujl/yuque-mcp
- Package
@wwwwwujl/yuque-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active