> **🚀 Don't want to self-host?** [Join the waitlist for our fully managed solution →](https://mcpengage.com/wrike)
> 
> Zero setup. Zero maintenance. Just connect and automate.

---

# 🚀 Wrike MCP Server — 2026 Complete Version

## 💡 What This Unlocks

**This MCP server gives AI direct access to your entire Wrike workspace.** Instead of navigating folders, projects, and tasks manually, you just *tell* Claude what you need—and it executes instantly across your enterprise work management platform.

### 🎯 Wrike-Specific Power Moves

The AI can directly control your Wrike workspace with natural language. Here are **5 real workflows** using the actual tools in this MCP server:

1. **📊 Project Portfolio Health Check**
   - AI uses `list_projects` → `list_tasks` (per project) → analyzes status distribution and completion rates
   - Identifies at-risk projects (high % of Deferred/Cancelled tasks, overdue tasks piling up)
   - *"Show me all active projects, calculate task completion rates, and flag any with 20%+ deferred tasks or overdue work"*

2. **🔥 Priority Escalation Workflow**
   - AI calls `list_tasks` with status filters to find urgent work
   - Uses `update_task` to escalate importance (High → Critical) and adjust due dates
   - Calls `add_comment` to notify stakeholders of priority shifts
   - *"Find all High importance tasks due in next 3 days, escalate to Critical, push due dates by 1 day, and comment to notify project leads"*

3. **👥 Resource Allocation Intelligence**
   - AI uses `list_users` to get team roster → `list_tasks` filtered by assignee (responsibles)
   - Calculates workload distribution, identifies over-allocated team members
   - *"Show me task counts per team member for active projects, flag anyone with 15+ active tasks, and suggest redistribution"*

4. **🗂️ Folder Structure Audit**
   - AI chains `list_folders` → `list_folders` (recursively for subfolders) → `list_tasks` (per folder)
   - Maps entire workspace hierarchy, identifies empty folders or orphaned tasks
   - *"Audit my folder structure: show folder tree, task counts in each, and flag any folders with 0 tasks or 100+ tasks"*

5. **📅 Sprint Planning & Assignment**
   - AI uses `list_tasks` (filtered by project/folder) to pull backlog
   - Calls `create_task` in batch to set up sprint tasks with due dates and assignees
   - Uses `update_task` to bulk-assign tasks based on team capacity from `list_users`
   - *"Pull backlog from 'Product Dev' folder, create 10 sprint tasks with names from list, assign round-robin to dev team, due dates staggered over 2 weeks"*

### 🔗 The Real Power: Chaining Operations

AI doesn't just execute single commands—it orchestrates **multi-step workflows**:

- **Cross-Project Reporting** → `list_projects` → `list_tasks` (per project, status filters) → Generate burndown charts
- **Task Migration** → `list_tasks` (source folder) → `create_task` (destination folder) → `update_task` (archive source)
- **Team Rebalancing** → `list_users` → `list_tasks` (per user) → `update_task` (reassign overloaded users) → `add_comment` (notify)

## 📦 What's Inside

**8 production-ready Wrike API tools** covering core work management operations:

| Tool | Purpose |
|------|---------|
| `list_tasks` | Query tasks with filters (folder, status, limit) |
| `get_task` | Fetch detailed task info (including custom fields) |
| `create_task` | Create new tasks with metadata (title, desc, status, importance, dates, responsibles) |
| `update_task` | Update existing tasks (title, desc, status, importance, dates, add/remove responsibles) |
| `list_folders` | List folders (can filter by parent folder for hierarchy) |
| `list_projects` | List all projects (projects are folders with project=true flag) |
| `add_comment` | Add comments to tasks (supports markdown) |
| `list_users` | List all users/contacts in your Wrike workspace |

All tools include proper error handling, automatic authentication (OAuth Bearer tokens), and full TypeScript types.

## 🚀 Quick Start

### Option 1: Claude Desktop (Local)

1. **Clone and build:**
   ```bash
   git clone https://github.com/BusyBee3333/Wrike-MCP-2026-Complete.git
   cd wrike-mcp-2026-complete
   npm install
   npm run build
   ```

2. **Get your Wrike Access Token:**
   
   Wrike uses **OAuth 2.0** (or permanent access tokens for apps):
   
   - **For personal use (easiest):**
     1. Go to your Wrike account → **Settings** → **Apps & Integrations**
     2. Click **API** tab → **Create Token**
     3. Set a name (e.g., "MCPEngage MCP Server") and select scopes (`wsReadWrite` for full access)
     4. Copy the **Permanent Access Token** (starts with Bearer token format, very long string)
   
   - **For OAuth apps (advanced):**
     - Follow [Wrike OAuth Guide](https://developers.wrike.com/oauth-20-authorization/) to create an app
     - Use authorization code flow to get refresh/access tokens
     - This MCP server expects a direct access token in `WRIKE_ACCESS_TOKEN`

3. **Configure Claude Desktop:**
   
   On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
   
   On Windows: `%APPDATA%\Claude\claude_desktop_config.json`

   ```json
   {
     "mcpServers": {
       "wrike": {
         "command": "node",
         "args": ["/ABSOLUTE/PATH/TO/wrike-mcp-2026-complete/dist/index.js"],
         "env": {
           "WRIKE_ACCESS_TOKEN": "your_long_access_token_here"
         }
       }
     }
   }
   ```

4. **Restart Claude Desktop** — the 🔌 icon should show "wrike" connected

### Option 2: Deploy to Railway

[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/template/wrike-mcp)

1. Click the button above
2. Set `WRIKE_ACCESS_TOKEN` in Railway dashboard
3. Use the Railway URL as your MCP server endpoint

### Option 3: Docker

```bash
docker build -t wrike-mcp .
docker run -p 3000:3000 \
  -e WRIKE_ACCESS_TOKEN=your_token \
  wrike-mcp
```

## 🔐 Authentication

**Wrike uses OAuth 2.0 Bearer tokens** for API authentication.

- **Permanent Access Tokens:** Easiest for personal/internal use (create in Wrike Settings → API)
- **OAuth Apps:** For public integrations (requires authorization flow, refresh tokens)
- **Scopes:** `wsReadWrite` grants full read/write access to workspace
- **Security:** Tokens are sensitive—store securely, never commit to version control

📖 **Official docs:** [Wrike API Authentication](https://developers.wrike.com/api/v4/authentication/)

The MCP server automatically includes `Authorization: Bearer <token>` headers on all requests.

## 🎯 Example Prompts for Work Management

Once connected to Claude, use these natural language prompts:

**Project & Task Management:**
- *"Show me all active projects, list task counts in each, and identify projects with 0 tasks or 50+ tasks"*
- *"Get all tasks in project IEABCDEF123, filter by status Active, and show me which are overdue"*
- *"Create 5 tasks in folder IEABCDEF456: 'Requirements doc', 'Design review', 'Implementation', 'QA testing', 'Deployment'"*

**Task Operations:**
- *"Update task IEABCDEF789 to status 'Completed', set importance to Normal, and add a comment 'Finished ahead of schedule'"*
- *"Find all tasks with status Deferred in the Engineering folder, change status to Active, and set due dates to next Friday"*

**Team & Resource Management:**
- *"List all users in my Wrike workspace and show me their contact info"*
- *"Show me all tasks assigned to user IEABCDEF123, group by project, and calculate total active task count"*
- *"Find tasks assigned to Sarah (user ID IEABCDEF456) that are overdue, reassign to Tom (IEABCDEF789), and add comment explaining why"*

**Workspace Intelligence:**
- *"Audit my folder structure: list all folders, subfolders, and task counts—flag any folders with 100+ tasks as needing reorganization"*
- *"Pull all tasks created in last 7 days across my workspace, group by folder, and summarize what's being worked on"*

**Reporting & Analytics:**
- *"Get all tasks from Q1 projects with status Completed or Cancelled, calculate completion rate, and identify which projects shipped on time"*
- *"Show me all Critical importance tasks across my workspace with due dates in next 48 hours—highlight any blockers"*

## 🛠️ Development

### Prerequisites
- Node.js 18+
- npm or yarn
- Wrike account with API access

### Setup

```bash
git clone https://github.com/BusyBee3333/Wrike-MCP-2026-Complete.git
cd wrike-mcp-2026-complete
npm install
cp .env.example .env
# Edit .env with your Wrike access token
npm run build
npm start
```

### Testing

```bash
npm test                  # Run all tests
npm run test:watch        # Watch mode
npm run test:coverage     # Coverage report
```

### Project Structure

```
wrike-mcp-2026-complete/
├── src/
│   └── index.ts          # Main MCP server + Wrike API client
├── dist/                 # Compiled JavaScript (after build)
├── package.json
├── tsconfig.json
└── .env.example
```

## 🐛 Troubleshooting

### "Authentication failed" or 401/403 errors
- Verify your access token is correctly set in `WRIKE_ACCESS_TOKEN`
- Check token hasn't expired (permanent tokens don't expire unless revoked)
- Ensure token has `wsReadWrite` scope (or appropriate permissions)
- Verify token in Wrike Settings → Apps & Integrations → API

### "Folder not found" or "Task not found"
- Wrike IDs are case-sensitive and start with `IE` followed by alphanumeric
- Use `list_folders` or `list_projects` to get exact IDs
- Some folders/tasks may be in archived spaces—check workspace settings

### "Tools not appearing in Claude"
- Restart Claude Desktop after updating config
- Verify path in `claude_desktop_config.json` is **absolute**
- Check `dist/index.js` exists after `npm run build`
- View logs: macOS `~/Library/Logs/Claude/mcp*.log`

### Rate limits
- Wrike API limits: Varies by plan (free: 100 req/min, paid: higher)
- The MCP server doesn't implement rate limiting yet—add delays for bulk operations
- Check rate limit headers in responses if hitting limits

### Date format issues
- Wrike expects dates in **YYYY-MM-DD** format for `start_date` and `due_date`
- Timestamps are returned as ISO 8601 strings
- Custom date fields may have different formats—check API docs

## 📖 Resources

- **[Wrike API v4 Documentation](https://developers.wrike.com/api/v4/)** — Official REST API reference
- **[Wrike API Getting Started](https://developers.wrike.com/getting-started/)** — Quickstart guide
- **[Wrike OAuth 2.0 Guide](https://developers.wrike.com/oauth-20-authorization/)** — OAuth setup
- **[MCP Protocol Specification](https://modelcontextprotocol.io/)** — How MCP servers work
- **[Claude Desktop Documentation](https://claude.ai/desktop)** — Configure AI integrations

## 🤝 Contributing

Contributions are welcome! Missing a Wrike feature? Want to add custom fields, timelog, or dependency management? Open a PR.

**How to contribute:**

1. Fork this repo
2. Create a feature branch (`git checkout -b feature/add-custom-fields`)
3. Add your tool definition in `src/index.ts` (follow existing patterns)
4. Test locally with Claude Desktop
5. Commit your changes (`git commit -m 'Add custom fields support'`)
6. Push to your fork (`git push origin feature/add-custom-fields`)
7. Open a Pull Request with details

## 📄 License

MIT License - see [LICENSE](LICENSE) for details.

You're free to use, modify, and distribute this MCP server for personal or commercial projects.

## 🙏 Credits

Built by **[MCPEngage](https://mcpengage.com)** — AI infrastructure for business software.

This server is part of the **MCPEngage 2026 Complete Series**, providing production-ready MCP servers for 30+ business platforms.

**Want more?** Check out our full catalog:
- [Asana MCP Server](https://github.com/BusyBee3333/Asana-MCP-2026-Complete) — Project management
- [ClickUp MCP Server](https://github.com/BusyBee3333/ClickUp-MCP-2026-Complete) — All-in-one PM
- [Jira MCP Server](https://github.com/BusyBee3333/Jira-MCP-2026-Complete) — Issue tracking
- [Trello MCP Server](https://github.com/BusyBee3333/Trello-MCP-2026-Complete) — Kanban boards
- ...and 26 more at [mcpengage.com](https://mcpengage.com)

---

**Questions?** Open an issue or join our [Discord community](https://discord.gg/mcpengage) (invite on mcpengine.pages.dev).