Meegle MCP

Meegle (Feishu Project) OpenAPI MCP Server — connect AI agents to Meegle project management via the Model Context Protocol.

102 MCP tools across 13 groups: space, workitem, workflow, subtask, comment, view, attachment, workhour, user, tenant, measure, config, agent.

📋 Prerequisites

| Item | Description | Source | |------|-------------|--------| | pluginId | Plugin ID | Plugin configuration page | | pluginSecret | Plugin secret | Plugin configuration page | | userKey | Operating user identity | Space member list |

Optional: domain (default https://project.feishu.cn), Node.js >= 20.

🚀 Quick Start

Installation

npm install -g @anthropic/meegle-mcp

Cursor / Claude Desktop

Add to your MCP configuration:

{
  "mcpServers": {
    "meegle": {
      "command": "npx",
      "args": [
        "-y", "@anthropic/meegle-mcp", "mcp",
        "--plugin-id", "<PLUGIN_ID>",
        "--plugin-secret", "<PLUGIN_SECRET>",
        "--user-key", "<USER_KEY>"
      ]
    }
  }
}

Environment Variables

export MEEGLE_PLUGIN_ID=<PLUGIN_ID>
export MEEGLE_PLUGIN_SECRET=<PLUGIN_SECRET>
export MEEGLE_USER_KEY=<USER_KEY>

npx @anthropic/meegle-mcp mcp

🛠 Tool Presets

Control which tools are enabled with -t:

| Preset | Count | Use Case | |--------|:-----:|----------| | preset.light | 8 | Read-only basics | | preset.default | 28 | Standard PM operations | | preset.pm.full | 62 | Full project management | | preset.all | 102 | Everything | | preset.workitem.default | 8 | Work item CRUD & search | | preset.workflow.default | 5 | Workflow state management | | preset.view.default | 3 | View queries | | preset.config.default | 6 | Configuration inspection |

# Light preset
npx @anthropic/meegle-mcp mcp -i <ID> -s <SECRET> -t "preset.light"

# All 102 tools
npx @anthropic/meegle-mcp mcp -i <ID> -s <SECRET> -t "preset.all"

# Mix presets with individual tools
npx @anthropic/meegle-mcp mcp -i <ID> -s <SECRET> -t "preset.light,meegle.comment.add"

See Tool Presets Reference and Full Tools List for details.

🌐 Domain Configuration

# Default
npx @anthropic/meegle-mcp mcp -i <ID> -s <SECRET>
# → https://project.feishu.cn

# Custom domain
npx @anthropic/meegle-mcp mcp -i <ID> -s <SECRET> -d "https://your-domain.com"

📡 Transport Modes

| Mode | Flag | Use Case | |------|------|----------| | stdio | -m stdio | Cursor, Claude Desktop, CLI (default) | | streamable | -m streamable | HTTP deployment, team sharing | | sse | -m sse | Legacy HTTP polling (deprecated) |

# Streamable HTTP
npx @anthropic/meegle-mcp mcp -i <ID> -s <SECRET> -m streamable -p 3000
# → http://localhost:3000/mcp

⚙️ Advanced Configuration

Config File

npx @anthropic/meegle-mcp mcp --config config.json

{
  "pluginId": "<ID>",
  "pluginSecret": "<SECRET>",
  "userKey": "<KEY>",
  "domain": "https://project.feishu.cn",
  "tools": ["preset.default"],
  "toolNameCase": "snake",
  "mode": "stdio"
}

Tool Name Case

| Case | Example | Flag | |------|---------|------| | dot (default) | meegle.workitem.create | -c dot | | snake | meegle_workitem_create | -c snake | | camel | meegleWorkitemCreate | -c camel | | kebab | meegle-workitem-create | -c kebab |

Configuration Priority

Command line > Environment variables > Config file > Defaults

📚 Documentation

| Document | Description | |----------|-------------| | CLI Reference | All command parameters | | Tool Presets | Preset collections matrix | | Tools List | All 102 tools with API paths | | Configuration Guide | Setup scenarios | | FAQ | Common issues & solutions |

Author

Nguyen Ngoc Tuan Founder & CEO, Transform Group Lark Platinum Partner Email: jimmy@transform.vn

License

MIT

MCP Servers