@quillmeetings/manus-mcp

MCP server for the Manus AI Agent API. Exposes Manus tasks, projects, and files as tools for Claude and other MCP clients.

Setup

1. Get an API key

Generate one at https://manus.im/app#settings/integrations/api

2. Configure your MCP client

Claude Code:

claude mcp add manus -e MANUS_API_KEY=your-key-here -- npx @quillmeetings/manus-mcp

MCP settings JSON:

{
  "mcpServers": {
    "manus": {
      "command": "npx",
      "args": ["@quillmeetings/manus-mcp"],
      "env": {
        "MANUS_API_KEY": "your-key-here"
      }
    }
  }
}

Tools (12)

Tasks (6)

| Tool | Description | |------|-------------| | create_task | Create a new Manus AI agent task. Returns immediately — poll with get_task. Optionally attach a file via file_url. | | get_task | Get task status, output, and credit usage. Poll until completed or failed. | | list_tasks | List tasks with filters (status, date range, project, query). Supports cursor pagination. | | update_task | Update task title, sharing, or visibility. | | delete_task | Permanently delete a task. | | continue_task | Send a follow-up message for multi-turn conversation on a completed task. |

Projects (2)

| Tool | Description | |------|-------------| | create_project | Create a project to organize tasks with optional default instructions. | | list_projects | List all projects. |

Files (4)

| Tool | Description | |------|-------------| | create_file | Create a file record and get a presigned S3 upload URL. | | list_files | List recently uploaded files. | | get_file | Get file details by ID. | | delete_file | Delete a file. |

Typical workflow

User: "Use Manus to research competitor pricing for Acme Corp"

1. create_task({ prompt: "Research competitor pricing..." })
   → { task_id: "abc123", task_url: "https://manus.im/app/abc123" }

2. Share task_url with user, wait ~1-5 minutes

3. get_task({ task_id: "abc123" })
   → { status: "completed", output: [...], credit_usage: 200 }

4. Present results to user

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | MANUS_API_KEY | Yes | API key from Manus settings |

Development

npm install
npm test          # watch mode
npm run test:run  # single run
npm run build     # compile TypeScript
npm run inspector # MCP inspector