📦

Wolai MCP

MCP Server for Wolai — Connect AI agents to your Wolai knowledge base

0 installs

1 stars

Trust: 59 — Fair

Devtools

Installation

npx wolai-mcp

Ask AI about Wolai MCP

I know everything about Wolai MCP. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

Wolai MCP Icon

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

Go to Wolai Developer Console
Create an application → get App ID and App Secret
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.