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