Monday.com MCP Server

A Monday.com Model Context Protocol (MCP) server implementation in TypeScript for handling Monday.com task-related operations.

Available Tools

This MCP server provides the following tools for interacting with Monday.com:

• my-items: Get items assigned to the current user for the configured board
• add-task: Add a new task (item) to the Monday.com board
• update-task-status: Update the status of a task (item) with intelligent status matching
• update-task: Update a task (item) with custom column values (advanced)
• get-groups: Get all groups from the Monday.com board

Status Update Examples

The update-task-status tool provides intelligent status matching. You can use natural language like:

• "in progress" - matches "In Progress", "Working", "WIP", etc.
• "done" - matches "Done", "Complete", "Completed", "Finished", etc.
• "in review" - matches "In Review", "Review", "Pending Review", etc.
• "stuck" - matches "Stuck", "Blocked", "Blocker", etc.

Getting Started

Option 1: Direct Usage (Recommended)

Use the package directly with pnpm dlx without cloning:

1. Configure MCP Server

   Configure your environment variables in your ~/.cursor/mcp.json file:

   {
     "mcpServers": {
       "monday": {
         "command": "pnpm",
         "args": ["dlx", "@nasseratic/monday-mcp-server@latest"],
         "env": {
           "MONDAY_API_TOKEN": "your_monday_api_token",
           "MONDAY_TASKS_BOARD_ID": "your_monday_board_id"
         }
       }
     }
   }

   • MONDAY_API_TOKEN: Your Monday.com API token (v2 Token)
   • MONDAY_TASKS_BOARD_ID: The ID of the Monday.com board containing your tasks

Option 2: Development Setup

If you want to modify the source code or contribute:

1. Clone the repository

   git clone https://github.com/Nasseratic/mcp-server-monday.git
   cd mcp-server-monday

2. Install dependencies

   pnpm install

3. Development Configuration

   Configure your environment variables in your ~/.cursor/mcp.json file to use the local development version:

   {
     "mcpServers": {
       "monday": {
         "command": "pnpm",
         "args": ["start"],
         "cwd": "/path/to/your/mcp-server-monday",
         "env": {
           "MONDAY_API_TOKEN": "your_monday_api_token",
           "MONDAY_TASKS_BOARD_ID": "your_monday_board_id"
         }
       }
     }
   }

   • Replace /path/to/your/mcp-server-monday with the actual path where you cloned the repository.

Monday.com API Setup

To get your Monday.com API token:

1. Go to your Monday.com account
2. Click on your avatar > Developers > My API tokens
3. Generate a new API token with appropriate permissions

To get your Monday.com board ID:

1. Open the board in Monday.com
2. The board ID is the number in the URL after "boards/"