🤖 Agent Toolkit

The @mondaydotcomorg/agent-toolkit package provides a powerful set of tools and utilities for building AI agents that interact with the monday.com API, supporting both OpenAI and Model Context Protocol (MCP) implementations.

🚀 Quick Start: Hosted MCP (Recommended)

The fastest, most robust, and reliable way to connect to monday.com. Our hosted MCP service handles all the infrastructure for you - no local setup, automatic updates, and improved performance.

📚 Integration Guides

Get started with your favorite AI platform:

• Get Started Guide - First time using monday MCP?
• Claude Integration - Connect with Claude Desktop
• Cursor Integration - Integrate with Cursor IDE
• ChatGPT Integration - Connect with ChatGPT
• MS Copilot Integration - Integrate with Microsoft Copilot Studio
• Mistral Integration - Connect with Mistral AI's le Chat
• Ready-to-Use Prompts - Example prompts to get started

Quick Setup with Hosted MCP

For Cursor

Simply add this to your MCP settings:

{
  "mcpServers": {
    "monday-mcp": {
      "url": "https://mcp.monday.com/mcp"
    }
  }
}

Why Use the Hosted MCP?

• ✅ No local installation - Works immediately without setup
• ✅ Automatic updates - Always get the latest features
• ✅ Better performance - Optimized infrastructure
• ✅ OAuth authentication - Secure token management
• ✅ Workspace controls - Limit access to specific workspaces
• ✅ Higher reliability - Enterprise-grade uptime

When to Use This Repository Instead

You might want to run the MCP locally or use the agent toolkit if you need to:

• 🔧 Customize the MCP server - Modify the source code for specific needs
• 🛠️ Build custom agents - Use the agent toolkit for OpenAI or custom implementations
• 🔌 Work offline - Develop without internet connectivity
• 🧪 Contribute to development - Help improve the MCP server or toolkit

🏁 Local Installation Guide

Step 1: Create a monday.com Account

If you don't already have a monday.com account:

1. Go to monday.com and sign up for an account
2. Create your first workspace and board to get started

Step 2: Generate an API Token

To interact with monday.com's API, you'll need an API token:

1. Log in to your monday.com account
2. Click on your avatar in the bottom-left corner
3. Select "Developers"
4. Click "My access tokens" on the left menu
5. Copy your personal access token

Step 3: Configure Your MCP Client

For Claude Desktop

1. Open Claude Desktop
2. Go to Settings → MCP Servers
3. Add a new server with this configuration:

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }
  }
}

For Gemini CLI

To get started with Gemini CLI, you can use the official Gemini CLI extension for monday.com.

The Gemini CLI extension bundles the monday.com MCP server with a context file and custom commands that teaches Gemini how to use the monday.com tools for powerful workflows.

To install the extension run the following command in your terminal:

gemini extensions install https://github.com/mondaycom/mcp

If you prefer to use the MCP server directly without the extension, you can add it with this command:

gemini mcp add -t http monday https://mcp.monday.com/mcp

Once you have either the extension installed or the MCP server added, start Gemini CLI by running:

gemini

Then, authenticate with your monday.com account by running the following command inside Gemini CLI:

/mcp auth monday

This will open a browser window to complete the authentication process. After authenticating, all the monday.com tools and custom commands will be available.

A few custom command to try out for the extension:

• /monday:create-item create item in board 123 for "Update the UI"
• /monday:sprint-summary sprint summary for sprint 853

For Cursor or Other MCP Clients (Local Setup)

Add to your settings:

{
  "mcpServers": {
    "monday-api-mcp": {
      "command": "npx",
      "args": [
        "@mondaydotcomorg/monday-api-mcp@latest"
      ],
      "env": {
        "MONDAY_TOKEN": "your_monday_api_token"
      }
    }
  }
}

Step 5: Test Your Integration

1. Ask Claude or your AI assistant a question like:

   • "What items do I have in board 123?"
   • "Can you create a board to manage my project?"

2. Your assistant should now be able to interact with your monday.com account!

⚙️ Advanced Hosted MCP Configuration

Using Authorization Headers

To specify a custom authorization header and API version with the hosted MCP:

{
  "mcpServers": {
    "monday-api-mcp-hosted": {
      "command": "npx",
      "args": [
        "-p",
        "node@20",
        "mcp-remote",
        "https://mcp.monday.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <your_token>"
      }
    }
  }
}

Specifying API Version

You can specify the API version you want to use with the --header parameter:

{
  "mcpServers": {
    "monday-api-mcp-hosted": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.monday.com/mcp",
        "--header",
        "Api-Version:${API_VERSION}"
      ],
      "env": {
        "API_VERSION": "2025-07"
      }
    }
  }
}

Installing the Monday MCP App

For OAuth authentication and workspace controls, install the Monday MCP app from the marketplace:

1. Visit monday MCP app in the marketplace
2. Click "Install" and follow the instructions to add it to your account

🧰 Available Tools

Our MCP server provides a rich set of tools that give AI assistants the ability to interact with monday.com:

| Category | Tool | Description | |----------|------|-------------| | Item Operations | create_item | Create a new item in a monday.com board with specified column values | | | delete_item | Delete an item from a board permanently | | | get_board_items_by_name | Search for items by board ID and term/name | | | create_update | Add an update/comment to a specific item | | | change_item_column_values | Modify the column values of an existing item | | | move_item_to_group | Move an item to a different group within the same board | | Board Operations | create_board | Create a new monday.com board wit