mcpengine/servers/wrike/README.md

Wrike MCP Server

A complete Model Context Protocol (MCP) server for Wrike API v4, providing 60+ tools and 22 React-based UI apps for comprehensive project management integration.

Features

60+ MCP Tools

Tasks (9 tools)

• wrike_list_tasks - List tasks with filters
• wrike_get_task - Get task details
• wrike_create_task - Create new task
• wrike_update_task - Update task
• wrike_delete_task - Delete task
• wrike_list_subtasks - List subtasks
• wrike_create_subtask - Create subtask
• wrike_list_dependencies - List task dependencies
• wrike_add_dependency - Add task dependency

Folders (7 tools)

• wrike_list_folders - List folders
• wrike_get_folder - Get folder details
• wrike_create_folder - Create folder
• wrike_update_folder - Update folder
• wrike_delete_folder - Delete folder
• wrike_list_folder_tasks - List tasks in folder
• wrike_copy_folder - Copy folder

Projects (6 tools)

• wrike_list_projects - List projects
• wrike_get_project - Get project details
• wrike_create_project - Create project
• wrike_update_project - Update project
• wrike_delete_project - Delete project
• wrike_list_project_tasks - List project tasks

Spaces (5 tools)

• wrike_list_spaces - List spaces
• wrike_get_space - Get space details
• wrike_create_space - Create space
• wrike_update_space - Update space
• wrike_delete_space - Delete space

Contacts (3 tools)

• wrike_list_contacts - List contacts/users
• wrike_get_contact - Get contact details
• wrike_update_contact - Update contact

Comments (5 tools)

• wrike_list_comments - List comments
• wrike_get_comment - Get comment
• wrike_create_comment - Create comment
• wrike_update_comment - Update comment
• wrike_delete_comment - Delete comment

Timelogs (5 tools)

• wrike_list_timelogs - List time logs
• wrike_get_timelog - Get timelog
• wrike_create_timelog - Create timelog
• wrike_update_timelog - Update timelog
• wrike_delete_timelog - Delete timelog

Attachments (4 tools)

• wrike_list_attachments - List attachments
• wrike_get_attachment - Get attachment details
• wrike_download_attachment - Download attachment
• wrike_delete_attachment - Delete attachment

Workflows (4 tools)

• wrike_list_workflows - List workflows
• wrike_get_workflow - Get workflow
• wrike_create_workflow - Create workflow
• wrike_update_workflow - Update workflow

Custom Fields (4 tools)

• wrike_list_custom_fields - List custom fields
• wrike_get_custom_field - Get custom field
• wrike_create_custom_field - Create custom field
• wrike_update_custom_field - Update custom field

Approvals (5 tools)

• wrike_list_approvals - List approvals
• wrike_get_approval - Get approval
• wrike_create_approval - Create approval
• wrike_update_approval - Update approval
• wrike_delete_approval - Delete approval

Groups (5 tools)

• wrike_list_groups - List groups
• wrike_get_group - Get group
• wrike_create_group - Create group
• wrike_update_group - Update group
• wrike_delete_group - Delete group

Invitations (4 tools)

• wrike_list_invitations - List invitations
• wrike_create_invitation - Create invitation
• wrike_update_invitation - Update invitation
• wrike_delete_invitation - Delete invitation

Webhooks (4 tools)

• wrike_list_webhooks - List webhooks
• wrike_create_webhook - Create webhook
• wrike_update_webhook - Update webhook
• wrike_delete_webhook - Delete webhook

22 React MCP Apps

All apps feature dark theme and client-side state management:

1. task-dashboard - Overview of all tasks with filters
2. task-detail - Detailed task view and editor
3. task-grid - Tabular task view
4. task-board - Kanban-style task board
5. project-dashboard - Project overview with status
6. project-detail - Detailed project view
7. project-grid - Tabular project view
8. folder-tree - Hierarchical folder navigation
9. space-overview - Space management dashboard
10. gantt-view - Timeline/Gantt visualization
11. time-dashboard - Time tracking overview
12. time-entries - Create time log entries
13. member-workload - Team member workload view
14. comment-thread - Task comment threads
15. approval-manager - Approval requests manager
16. workflow-editor - Workflow configuration
17. custom-fields-manager - Custom field management
18. attachment-gallery - File attachment gallery
19. search-results - Search tasks and folders
20. activity-feed - Recent activity stream
21. sprint-board - Sprint planning board
22. reports-dashboard - Analytics and reports

Installation

npm install
npm run build

Configuration

Set your Wrike API token as an environment variable:

export WRIKE_API_TOKEN="your-api-token-here"

You can get a permanent API token from your Wrike account:

1. Go to Apps & Integrations
2. Click on API
3. Create a new permanent token

Usage

As MCP Server

Add to your MCP client configuration:

{
  "mcpServers": {
    "wrike": {
      "command": "node",
      "args": ["/path/to/wrike-mcp-server/dist/main.js"],
      "env": {
        "WRIKE_API_TOKEN": "your-api-token"
      }
    }
  }
}

Standalone

npm start

Architecture

wrike/
├── src/
│   ├── clients/
│   │   └── wrike.ts          # Wrike API client
│   ├── tools/
│   │   ├── tasks-tools.ts    # Task management tools
│   │   ├── folders-tools.ts  # Folder tools
│   │   ├── projects-tools.ts # Project tools
│   │   ├── spaces-tools.ts   # Space tools
│   │   ├── contacts-tools.ts # Contact tools
│   │   ├── comments-tools.ts # Comment tools
│   │   ├── timelogs-tools.ts # Time tracking tools
│   │   ├── attachments-tools.ts # Attachment tools
│   │   ├── workflows-tools.ts   # Workflow tools
│   │   ├── custom-fields-tools.ts # Custom field tools
│   │   ├── approvals-tools.ts   # Approval tools
│   │   ├── groups-tools.ts      # Group tools
│   │   ├── invitations-tools.ts # Invitation tools
│   │   └── webhooks-tools.ts    # Webhook tools
│   ├── types/
│   │   └── wrike.ts          # TypeScript type definitions
│   ├── ui/
│   │   └── react-app/        # 22 React MCP apps
│   ├── server.ts             # MCP server implementation
│   └── main.ts               # Entry point
├── package.json
├── tsconfig.json
└── README.md

API Coverage

This server implements the complete Wrike API v4:

• ✅ Tasks & Subtasks
• ✅ Folders & Projects
• ✅ Spaces
• ✅ Contacts & Groups
• ✅ Comments
• ✅ Time Tracking
• ✅ Attachments
• ✅ Workflows & Custom Statuses
• ✅ Custom Fields
• ✅ Approvals
• ✅ Invitations
• ✅ Webhooks
• ✅ Dependencies

Authentication

Supports both:

• OAuth2 Bearer Token - For user-specific access
• Permanent API Token - For service accounts and automation

Error Handling

The server includes comprehensive error handling:

• API request failures
• Rate limiting
• Invalid parameters
• Network errors
• Authentication errors

Contributing

Contributions welcome! Please ensure:

• TypeScript types are complete
• Tools follow MCP standards
• React apps maintain dark theme
• Error handling is comprehensive

License

MIT

Resources

• Wrike API Documentation
• Model Context Protocol
• MCP SDK