# Monday.com MCP

> Monday.com (Work Management & CRM) MCP Server gives your AI agent direct access to your entire work platform. You can list project boards, track task items across specific columns, and audit team workspaces using natural conversation. It lets you manage projects and resources without opening the UI.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** workflow-automation, task-tracking, team-collaboration, project-boards, resource-management

## Description

You're connecting your AI agent directly to your Monday.com account. This server lets you manage every single thing—project boards, tasks, who owns what—using nothing but natural conversation. You don't gotta open the UI or click around; your agent handles it all.

**Discovering Project Structures**

You can get a full map of everything you work on. Start by listing all project boards available in your account with `list_boards`, or pull up a list of high-level organizational folders using `list_workspaces`. If you want to check the deep structure of any single board, use `get_board` to retrieve its complete column setup and metadata.

**Tracking and Retrieving Task Data**

Need to know what's going on with a specific project? Use `list_items` to pull up all tasks within a specified board ID. This function doesn't just give you names; it pulls the exact values from every custom column, so you can instantly see who's assigned or what the status is for dozens of rows at once. You can also get a simple list of those tasks using `list_items` if you only need titles and basic metadata.

Want to jump into the project without manual clicking? Just tell your agent to create new work using `create_item`, which adds a fresh row or task item directly onto any board you point it at. If an item already exists, you can update its status or details by calling `create_item` again.

**Managing Team Communication and Audit Trails**

You don't have to hunt through emails for updates. Your agent keeps a clean record of activity using `list_updates`, giving you the full history log—all comments, all changes—for any given task item. If someone needs to chime in, your agent can post a comment or update directly onto that specific task item using `create_update`.

**Auditing Users and Resources**

To verify who's doing what, you need user data. Your agent lists every active team member in your directory with `list_users`, letting you cross-reference identities when figuring out resource ownership or checking permissions across boards. You can also get the profile details of the person connected to the account using `get_me`.

Basically, this whole setup lets your AI client treat your entire work platform like a command line. It takes the manual effort out of project management—you'll list every board and workspace, pull specific data points from tasks across any column you name, manage communication updates on existing items, create new projects instantly using `create_item`, and check user assignments with `list_users` or audit the full activity log using `list_updates`. You get direct access to project boards, task columns, and user directories without ever leaving your chat window.

## Tools

### archive_item
Can be unarchived later from the board settings.

Archive a board item

### create_item
Adds a new row/task item to a specific project board.

### create_update
Posts a comment or update on an existing task item.

### delete_item
The item and its updates will be removed.

Permanently delete a board item

### get_board
Retrieves the full column structure and metadata for one specific board ID.

### get_me
Fetches the profile details of the currently connected user account.

### list_boards
Lists all project boards accessible in your Monday.com account.

### list_groups
List groups (sections) in a board

### list_items
Retrieves a list of tasks/rows within a specified board ID, including column data.

### list_subitems
List sub-items of a board item

### list_updates
Gets a history log (comments and updates) for a specific task item.

### list_users
Lists every active team member in your Monday.com account directory.

### list_workspaces
Retrieves a list of high-level organizational workspaces/folders.

## Prompt Examples

**Prompt:** 
```
List all boards in my Monday.com account
```

**Response:** 
```
I've retrieved 3 project boards from your account: 'Product Roadmap 2026' (ID: 12345), 'Marketing Campaign' (ID: 67890), and 'Inventory Sync' (ID: 13579). Which one would you like to list the tasks for?
```

**Prompt:** 
```
Show me all tasks in the 'Product Roadmap 2026' board
```

**Response:** 
```
Retrieving items from 'Product Roadmap 2026'… I've identified 12 tasks. Highlights include 'API Integration' (Status: Done), 'Mobile UI Design' (Status: Working on it), and 'Beta Testing' (Status: Stuck). Would you like to see the assignee for any of these?
```

**Prompt:** 
```
List all active team members in our Monday account
```

**Response:** 
```
I've retrieved your Monday.com user directory. There are 25 active members, including 'Alex Smith' (Admin), 'Sarah Johnson' (Member), and 'Mark Rivera'. I can help you find their internal IDs for task assignments if you'd like.
```

## Capabilities

### Discover Project Structures
List all project boards or workspaces, and retrieve the detailed column definitions and structural map of any board.

### Track and Retrieve Task Data
List specific task items within a board and pull exact values from custom columns (e.g., 'Due Date' or 'Status').

### Manage Team Communication
Add comments, updates, or audit the full history of activity for any task item.

### Audit User and Resource Assignments
List all team members in your account to verify user identities and cross-reference who owns which tasks across boards.

### Automate Project Creation
Create new task items on specified project boards, initiating work without manual clicks.

## Use Cases

### Weekly Status Report Generation
The PM needs a status report on 15 tasks across three different client boards. Instead of opening each board and copy-pasting data, the agent runs `list_items` for all three boards, extracts specific columns (Status, Due Date), and compiles a single summary table.

### Investigating Project Bottlenecks
The Ops Manager notices a key task is stalled. The agent uses `list_updates` on the item ID to check the comment history. It finds that Sarah commented three days ago saying 'Awaiting Legal Review,' immediately solving the bottleneck mystery.

### Onboarding New Team Members
A new hire needs access to project boards and team lists. The agent runs `list_users` first to verify all active employee IDs, then uses this list when creating initial task assignments for the new user.

### Rapid Project Scoping
The Team Lead needs to know if a proposed project fits within existing scope. The agent runs `list_boards` and `get_board` on potential candidates, confirming required columns (like 'Budget' or 'Priority') exist before starting the work.

## Benefits

- Skip the click-throughs. Instead of navigating multiple boards to check a single task's status, use `list_items` and specify the board ID directly in your prompt. You get the data instantly.
- Audit who did what and when. Use `list_updates` on an item. Your agent pulls the full comment history, so you don't have to scroll through five different tabs just to find out why a task was delayed.
- Know your structure before building. Running `get_board` gives you the exact column names and data types needed for any script or prompt, preventing broken API calls later.
- Stay compliant with user roles. Use `list_users` to get every team member's ID first. This ensures that when you use `create_item`, the task assignment targets a valid person in your company.
- See the big picture immediately. Start with `list_workspaces` to understand how departments organize their projects, giving context before diving into individual boards.

## How It Works

The bottom line is: you talk to your agent, and it talks directly to your work platform's API for you.

1. Subscribe to this server and provide your Monday.com API Token.
2. Your AI client calls the relevant tool (e.g., `list_boards`) with required parameters.
3. The server executes the request, retrieves structured data from Monday.com, and sends a clean JSON response back to your agent.

## Frequently Asked Questions

**How do I find all my project boards using list_boards?**
Running `list_boards` gives you a complete manifest of every board ID in your account. This is the first step before you can run any other command, like listing items on that board.

**Can I add comments using create_update?**
Yes. You provide the specific Item ID and the message content to `create_update`. This posts a comment or update without needing to open the actual task item page.

**What is the difference between list_items and get_board?**
`get_board` gives you the *structure* (the column names, like 'Budget' or 'Owner'). `list_items` uses that structure to pull *data* (the actual values for all tasks) from the board.

**How do I find out who is on my team? Use list_users.**
`list_users` runs an audit of your organization and returns a directory of every active user ID and their role. You can use these IDs later when creating tasks.

**What specific account scope details does the `get_me` tool provide?**
It returns your active caller identity and metadata context. This step confirms which user profile your agent is currently targeting, ensuring all actions stay within the correct account boundaries.

**When should I use `list_workspaces` instead of listing boards?**
Use `list_workspaces` first to map out high-level organizational grouping. This tool shows your department's top-tier 'folders,' helping you understand the overall project taxonomy before drilling down into individual boards.

**What is the difference between using `get_board` and `list_items`?**
`get_board` retrieves the entire structural blueprint of a board—including custom columns and dimension mappings. In contrast, `list_items` only fetches the actual data values for tasks that already exist on that specific board.

**How can I use `list_updates` to audit an item's history?**
The tool pulls a complete record of all updates and comments tied to a single task item. This is your definitive, chronological audit trail for tracking who changed the data and when.

**Can I see the column structure of a Monday board through my agent?**
Yes. Use the `get_board` tool with a specific Board ID. Your agent will retrieve the detailed structural configuration, exposing the custom column types and titles used to organize your project data.

**How do I list the tasks (items) within a specific board?**
The `list_items` tool retrieves all discrete GraphQL nodes representing rows in a board. Your agent will return the task names and their associated column values, helping you audit project progress without opening the browser.

**Can my agent navigate between different organizational workspaces?**
Absolutely. Use the `list_workspaces` tool to identify the top-level directory structure of your Monday account. Your agent will report the workspace names and IDs, allowing you to locate boards grouped by department or team.