DingTalk Wiki MCP Server

dingtalk-wiki-mcp

DingTalk Wiki / Docs read-write MCP server that fills the gap left by DingTalk official MCP.

中文文档 / Chinese docs

DingTalk's official MCP does not provide Wiki / Docs read-write capability.
This project is an open-source complement that makes AI agents and MCP clients actually able to read, browse, and create DingTalk Wiki / Docs content.

Repository Highlights

• Official MCP gap: Wiki / Docs read-write is not covered
• This project adds it: workspace browsing, node browsing, and document creation
• MCP-compatible: works with stdio-based MCP clients
• Agent-ready: includes SKILL.md for OpenClaw-style skill workflows

Quick Start

1) Install

npm install

2) Configure environment

cp .env.example .env

Required:

DINGTALK_APP_KEY=your-app-key
DINGTALK_APP_SECRET=your-app-secret

index.js now auto-loads .env from the current working directory (or the repo directory) if those variables are not already present in the environment.

3) Prepare local config

cp config.example.json config.json

4) Run

npm start

Or:

node index.js

npx dingtalk-wiki-mcp is a future-friendly path after npm publishing.
This repository already includes the correct CLI entry (bin), but npm distribution is not part of the current release yet.

DingTalk official MCP vs this project

Positioning principle: this project does not replace the official DingTalk MCP. It complements it by filling the Wiki / Docs gap.

Core capabilities

Wiki / Docs

• List Wiki workspaces
• Get workspace details
• List Wiki nodes (folders / docs)
• Create:
  • DOC
  • WORKBOOK
  • MIND
  • FOLDER
• Search Wiki by linking to DingTalk search
• Read Notable / .able sheets and records via official API

Organization

• List departments
• List department users
• Get user info

Operator / Config

• Set current operator (unionId)
• Use a default operator from local config
• Inspect current local config

Skill included

This repo is not only an MCP server. It also includes:

• SKILL.md

So it can be reused as a skill package in OpenClaw-style agent workflows.

Demo

1. List Wiki workspaces

2. Browse workspace nodes

3. Create a document

These demo images are illustrative documentation assets built from representative command/output flows, with all tenant-specific data removed.

Real use cases

1) AI automatically creates weekly report docs

Your AI agent can create a fresh DingTalk Wiki document every week for sales, product, or ops reporting.

2) Agent explores Wiki structure before writing

Before generating content, an agent can inspect workspaces and folders first, then choose the right target node.

3) Auto-initialize project knowledge-base structure

When a new project starts, automation can create a standard folder tree such as:

• Project Overview
• Weekly Reports
• Specs
• Release Notes
• Retrospectives

Client integration examples

• OpenClaw example
• mcporter example
• Generic MCP client example

Example usage

Registered server mode

If you have registered this server in your MCP client config under the name dingtalk-wiki:

mcporter call dingtalk-wiki.show_config
mcporter call dingtalk-wiki.list_wiki_workspaces
mcporter call dingtalk-wiki.list_wiki_nodes workspace_id="your_workspace_id"
mcporter call dingtalk-wiki.create_wiki_doc workspace_id="your_workspace_id" name="Weekly Summary" doc_type="DOC"
mcporter call dingtalk-wiki.get_user_info userid="your_user_id"

Direct stdio mode

If you want to run the