DingDingWiki_MCP

English | 中文

---

A Model Context Protocol (MCP) server that gives AI assistants (Claude Code, Cursor, Windsurf, etc.) read/write access to DingTalk (Dingtalk) Wiki knowledge bases.

• 8 MCP Tools: list_workspaces, list_nodes, get_node, read_document, write_document, create_document, create_folder, search
• Remote HTTP Transport: Streamable HTTP — no local install needed for end users
• Multi-user Sessions: Each user connects with their own DingTalk UnionId, 30min TTL with auto-cleanup
• Built-in Auth Page: Web UI for users to obtain their UnionId via DingTalk OAuth
• Markdown Read/Write: Documents are read and written as Markdown
• Minimal Dependencies: Only @modelcontextprotocol/sdk and zod

git clone https://github.com/sputnicyoji/DingDingWiki_MCP.git
cd DingDingWiki_MCP
npm ci && npm run build

Create .env.local with your DingTalk app credentials:

DINGTALK_APP_KEY=your_app_key
DINGTALK_APP_SECRET=your_app_secret
DINGTALK_CORP_ID=your_corp_id
PUBLIC_URL=http://your-server:3000

npm start

# Claude Code
claude mcp add dingtalk-wiki --transport http http://your-server:3000/mcp?uid=<your_union_id>

# OpenClaw
openclaw mcp set dingtalk-wiki '{"url":"http://your-server:3000/mcp?uid=<your_union_id>"}'

Cursor / Windsurf — add to .cursor/mcp.json or .windsurf/mcp.json:

{
  "mcpServers": {
    "dingtalk-wiki": {
      "url": "http://your-server:3000/mcp?uid=<your_union_id>"
    }
  }
}

To get your UnionId, open http://your-server:3000 in DingTalk's built-in browser and click verify.

docker build -t dingtalk-wiki-mcp .
docker run -d --restart unless-stopped -p 3000:3000 --env-file .env.local dingtalk-wiki-mcp

| Variable | Required | Default | Descr