Wolai MCP Server 🐺

English | 中文

Connect AI agents to your Wolai knowledge base via the Model Context Protocol (MCP).

Read, write, search, and navigate your Wolai pages — all from Claude, Gemini, Cursor, or any MCP-compatible AI agent.

---

✨ Features

Category	Tools	Description
📖 Read	get_page_content, list_child_blocks, get_root_info, get_breadcrumbs	Read pages, list children, navigate hierarchy
🔍 Search	search_pages_by_title	Fuzzy title search across page tree
✏️ Write	create_page, add_block, add_code_block	Create pages, append text/lists/headings/code
⚙️ Config	set_wolai_credentials, set_root_page, get_wolai_config	Runtime credential & root page management

11 tools total — covering read, write, search, and configuration.

---

🚀 Quick Start

Install

Option A: Quick Run with uvx (Recommended)

No installation needed — runs in a temporary isolated environment:

uvx wolai-mcp

Don't have uv? Install it: curl -LsSf https://astral.sh/uv/install.sh | sh

Option B: Install with pip

pip install wolai-mcp

Get Credentials

1. Go to Wolai Developer Console
2. Create an application → get App ID and App Secret
3. Find the Root Page ID from your Wolai page URL

---

📋 Configuration

All credentials are passed via environment variables — no need to edit any code.

Variable	Description	Required
WOLAI_APP_ID	Wolai Application ID	✅
WOLAI_APP_SECRET	Wolai Application Secret	✅
WOLAI_ROOT_ID	Root page ID for your knowledge base	Optional (for search/navigation)

---

🔧 Platform Configuration

Claude Desktop

Add to claude_desktop_config.json:

uvx (recommended)	pip
{ "mcpServers": { "wolai-kb": { "command": "uvx", "args": ["wolai-mcp"], "env": { "WOLAI_APP_ID": "your_app_id", "WOLAI_APP_SECRET": "your_secret", "WOLAI_ROOT_ID": "your_root_id" } } } }	{ "mcpServers": { "wolai-kb": { "command": "wolai-mcp", "env": { "WOLAI_APP_ID": "your_app_id", "WOLAI_APP_SECRET": "your_secret", "WOLAI_ROOT_ID": "your_root_id" } } } }

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "wolai-kb": {
      "command": "wolai-mcp",
      "env": {
        "WOLAI_APP_ID": "your_app_id",
        "WOLAI_APP_SECRET": "your_secret",
        "WOLAI_ROOT_ID": "your_root_id"
      }
    }
  }
}

Cursor / CherryStudio / Other MCP Clients

uvx	pip
{ "wolai-kb": { "command": "uvx", "args": ["wolai-mcp"], "env": { "WOLAI_APP_ID": "your_app_id", "WOLAI_APP_SECRET": "your_secret", "WOLAI_ROOT_ID": "your_root_id" } } }	{ "wolai-kb": { "command": "wolai-mcp", "env": { "WOLAI_APP_ID": "your_app_id", "WOLAI_APP_SECRET": "your_secret", "WOLAI_ROOT_ID": "your_root_id" } } }

---

💡 Usage Examples

Once configured, ask your AI agent:

• "读取我 Wolai 知识库的首页内容"
• "搜索标题包含'项目计划'的页面"
• "在首页下创建一个新页面叫'会议纪要'"
• "往指定页面添加一段代码"
• "显示当前 Wolai 配置状态"

---

🔐 Runtime Configuration

You can also change credentials at runtime without restarting:

• set_wolai_credentials — Switch Wolai account
• set_root_page — Change the root knowledge base page
• get_wolai_config — Check current configuration

---

💖 Support This Project

If you find Wolai MCP useful, consider buying me a coffee! Your support keeps this project alive and growing ✨

☕ 爱发电 (Afdian) Supports Alipay & WeChat Pay

💎 Crypto (USDC / ERC-20) Click to donate — supports MetaMask, SafePal & more

Every little bit helps — thank you! 🙏

---

📄 License

MIT License — see LICENSE for details.