Verdant Monday MCP

A Model Context Protocol (MCP) server for Monday.com, built with Node.js and TypeScript. This is a Node.js port of the Python mcp-server-monday.

Features

This MCP server provides tools to interact with Monday.com boards, items, groups, workspaces, and updates.

Workspace Operations

• monday_list_workspaces - List all workspaces in your Monday.com account

Board Operations

• monday_list_boards - List all boards in your Monday.com workspace (optionally filter by workspace ID)
• monday_get_board_groups - Get all groups from a specified board
• monday_get_board_columns - Get all columns from a specified board (including available labels)
• monday_create_board - Create a new board (public, private, or shareable)
• monday_create_board_group - Create a new group in an existing board

Item Operations

• monday_create_item - Create a new item or sub-item in a board
• monday_get_items_by_id - Fetch a specific item by its ID
• monday_update_item - Update column values for an item or sub-item
• monday_create_update - Create an update (comment) on an item
• monday_list_items_in_groups - List all items in specified groups with pagination support
• monday_list_subitems_in_items - List all sub-items for given items
• monday_move_item_to_group - Move an item to a different group
• monday_delete_item - Delete an item from a board
• monday_archive_item - Archive an item
• monday_get_item_updates - Get all updates/comments for a specific item

Setup

Prerequisites

• Node.js 20 or higher
• A Monday.com account with API access

Getting Your API Key

1. Create and save a personal API Token in Monday.com by following the instructions here
2. Get the Workspace Name from the URL of your Monday.com workspace. For example, if the URL is https://myworkspace.monday.com/, the workspace name is myworkspace

Installation

From Source

git clone <repository-url>
cd verdant-monday-mcp
npm install
npm run build

Using npm (when published)

npm install -g verdant-monday-mcp

Configuration

Environment Variables

Set the following environment variables:

export MONDAY_API_KEY="your_monday_api_key"
export MONDAY_WORKSPACE_NAME="your_workspace_name"  # Optional
export MONDAY_API_VERSION="2025-01"  # Optional, defaults to 2025-01

Or create a .env file (see .env.example):

cp .env.example .env
# Edit .env with your credentials

Claude Desktop Configuration

Add to your Claude Desktop config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "monday": {
      "command": "node",
      "args": ["/path/to/verdant-monday-mcp/build/index.js"],
      "env": {
        "MONDAY_API_KEY": "your_monday_api_key",
        "MONDAY_WORKSPACE_NAME": "your_workspace_name"
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "monday": {
      "command": "verdant-monday-mcp",
      "env": {
        "MONDAY_API_KEY": "your_monday_api_key",
        "MONDAY_WORKSPACE_NAME": "your_workspace_name"
      }
    }
  }
}

Usage

Running the Server

node build/index.js

Using with MCP Inspector

For debugging and testing:

npm run inspector

The Inspector will provide a URL you can open in your browser to interact with the server.

Development

Watch Mode

For development with auto-rebuild:

npm run watch

Building

npm run build

Docker

Build and run with Docker:

docker build -t verdant-monday-mcp .
docker run -i --rm \
  -e MONDAY_API_KEY="your_api_key" \
  -e MONDAY_WORKSPACE_NAME="your_workspace" \
  verdant-monday-mcp

Example Usage

Once configured with Claude Desktop or another MCP client, you can:

• "List all my Monday.com workspaces"
• "Show me all boards in workspace 12345"
• "List all my Monday.com boards"
• "Create a new item called 'Review PR' in board 12345 in the 'To Do' group"
• "Get all items from the 'In Progress' group in board 12345"
• "Add a comment to item 67890 saying 'This is complete'"
• "Move item 67890 to the 'Done' group"

Troubleshooting

Authentication Issues

• Verify your MONDAY_API_KEY is correct
• Check that your API key has the necessary permissions
• Ensure the API version is compatible (default: 2025-01)

Connection Issues

• Confirm you have internet connectivity
• Check if Monday.com API is accessible from your network
• Verify the API endpoint is correct

License

MIT

Credits

This is a Node.js/TypeScript port of the Python mcp-server-monday by Jovan Sakovic.