Nasseratic/mcp-server-monday

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
• get-item-details: Get detailed information for a specific item including all its columns and values

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_KEY": "your_monday_api_key",
          "MONDAY_TASKS_BOARD_ID": "your_monday_board_id"
        }
      }
    }
   

}

 - `MONDAY_API_KEY`: Your Monday.com API 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**

 ```bash
 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_KEY": "your_monday_api_key",
          "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/"