Meegle MCP Skill

Integrate Meegle (visual workflow and project management tool) with OpenClaw using the Model Context Protocol (MCP).

What is Meegle?

Meegle is a leading visual project management tool powered by Larksuite, designed for agile teams. It provides:

Customizable Kanban boards and Gantt charts
Real-time collaboration with integrated chat
Workflow automation and custom pipelines
Time tracking and analytics dashboard
Client portal access for external stakeholders

Setup

Prerequisites

You need:

A Meegle account with API access
Your MEEGLE_USER_KEY from your Meegle workspace

Configuration

Option 1: Environment Variable (Recommended)

Set your user key as an environment variable:

export MEEGLE_USER_KEY="your_user_key_here"
export MEEGLE_MCP_KEY="your_mcp_key_here"

Add this to your shell profile (~/.bashrc, ~/.zshrc, etc.) to persist across sessions.

Option 2: OpenClaw Config

Add the MCP server configuration to your OpenClaw settings:

Edit or create your OpenClaw MCP servers config file
Add the Meegle MCP server configuration:

{
  "mcpServers": {
    "meegle": {
      "command": "node",
      "args": ["{baseDir}/scripts/mcp-proxy.js"],
      "env": {
        "MEEGLE_USER_KEY": "your_user_key_here",
        "MEEGLE_MCP_URL": "https://project.larksuite.com/mcp_server/v1",
        "MEEGLE_MCP_KEY": "your_mcp_key_here"
      },
      "status": "active"
    }
  }
}

Option 3: Using mcporter (Alternative)

If you have mcporter installed:

mcporter add meegle \
  --url "https://project.larksuite.com/mcp_server/v1?mcpKey=your_mcp_key_here&userKey={user_key}" \
  --env MEEGLE_USER_KEY=your_user_key_here

Installation

Via ClawHub (Recommended):

clawhub install meegle-mcp

From GitHub:

git clone <this-repo-url> meegle-mcp
cd meegle-mcp
./scripts/setup.sh

Then restart OpenClaw and verify installation:

openclaw skills list | grep meegle

Available Tools

Once configured, the Meegle MCP server provides various tools for project management. Common operations include:

Project Management

List Projects: View all projects in your workspace
Create Project: Set up new projects with custom workflows
Update Project: Modify project details, status, or members

Task Operations

Create Task: Add new tasks with assignees, due dates, and priorities
List Tasks: Filter and search tasks by project, assignee, or status
Update Task: Change task properties, move between workflow stages
Get Task Details: View comprehensive task information

Workflow Management

Get Workflows: List available workflow templates
Apply Workflow: Assign workflows to projects
Update Workflow Stage: Move items through workflow stages

Team Collaboration

Add Members: Invite team members to projects
List Members: View project participants and roles
Update Permissions: Manage access levels

Analytics & Reporting

Get Project Stats: View progress, completion rates, and metrics
Time Tracking: Log and query time entries
Generate Reports: Create custom reports on project data

Usage Examples

Creating a New Project

Create a new Meegle project called "Q1 Website Redesign" with a Kanban workflow

Managing Tasks

Show me all high-priority tasks assigned to me in Meegle

Create a task in Meegle: "Update landing page copy" assigned to @designer, due next Friday

Workflow Operations

Move the task "Homepage mockups" to the "In Review" stage in Meegle

Team Coordination

Add john@company.com as a contributor to the "Mobile App" project in Meegle

Reporting

Generate a summary of completed tasks in Meegle for the past week

Limitations

Authentication: Requires a valid MEEGLE_USER_KEY with appropriate permissions
Rate Limits: Subject to Meegle API rate limits (check your plan)
Read-Only Operations: Some operations may be restricted based on your role
Workspace Scope: Only accesses projects in your authorized workspace

Security Notes

Never commit your MEEGLE_USER_KEY to version control
Store credentials in environment variables or secure config files
Review permissions before granting OpenClaw access to Meegle
Consider using a dedicated service account for automation

Troubleshooting

"Authentication failed" error

Verify your MEEGLE_USER_KEY is correct
Ensure the key has not expired or been revoked
Check that your Meegle account has API access enabled

"MCP server not responding"

Verify network connectivity to project.larksuite.com
Check that the MCP server URL and key are correct
Review OpenClaw logs: openclaw logs --filter=meegle

Tools not appearing

Restart OpenClaw after installation
Check skill is loaded: openclaw skills list
Verify environment variables are set correctly

Resources

Feedback

Issues or suggestions? Open an issue on the skill repository or contact via ClawHub.

Note: This skill uses the Model Context Protocol to communicate with Meegle's MCP server. Tool availability and capabilities depend on your Meegle plan and permissions.

meegle-mcp

Safety Notice

Copy this and send it to your AI assistant to learn