com.monday/monday.com

Install

Config snippet generator goes here (5 client tabs)

README

<div align="center">

# 🚀 monday.com MCP

<p>
  <a href="https://npmjs.com/package/@mondaydotcomorg/monday-api-mcp"><img src="https://img.shields.io/npm/v/@mondaydotcomorg/monday-api-mcp.svg?style=flat" alt="npm version"></a>
  <a href="https://github.com/mondaycom/mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
  <a href="https://github.com/mondaycom/mcp"><img src="https://img.shields.io/github/stars/mondaycom/mcp.svg?style=social" alt="GitHub Stars"></a>
  <img src="https://img.shields.io/badge/Node.js-v20+-green.svg" alt="Node.js Version">
  <img src="https://img.shields.io/badge/MCP-Compatible-blueviolet" alt="MCP Compatible">
  <img src="https://img.shields.io/badge/Claude-Ready-orange" alt="Claude Ready">
  <img src="https://img.shields.io/badge/OpenAI-Compatible-lightgrey" alt="OpenAI Compatible">
  <img src="https://img.shields.io/badge/TypeScript-Powered-blue" alt="TypeScript">
</p>

**Enable AI agents to operate reliably within real workflows. This MCP is monday.com's open framework for connecting agents into your work OS - giving them secure access to structured data, tools to take action, and the context needed to make smart decisions.**

</div>

## 🌟 Overview

This repository, maintained by the monday.com AI team, provides a comprehensive set of tools for AI agent developers who want to integrate with monday.com. Whether you're building AI assistants, automations, or custom integrations, our tools make it easy to connect to the monday.com platform.

**👉 New to monday MCP? Start here: [monday.com/w/mcp](https://monday.com/w/mcp)**

<https://github.com/user-attachments/assets/ed8d24e1-256b-4f6b-9d84-38e54a8703fd>

## 🔑 What is monday.com?

[monday.com](https://monday.com) is a work operating system that powers teams to run processes, projects, and everyday work. Teams use monday.com to plan, track, and manage their work in one centralized platform. It provides a visual, intuitive interface where teams can:

- Create and manage projects with customizable boards
- Track tasks through different stages with status columns
- Collaborate with team members through updates and mentions
- Automate workflows and integrate with other tools
- Visualize data with dashboards and reports

## 📦 What's Inside

### 💻 monday API MCP Server

The `@mondaydotcomorg/monday-api-mcp` package provides a plug-and-play server implementation for the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). It allows AI agents to interact with the monday.com API without needing to build complex integrations.

### 🤖 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](https://support.monday.com/hc/en-us/articles/28515034903314-Get-started-with-monday-MCP)** - First time using monday MCP?
- **[Claude Integration](https://support.monday.com/hc/en-us/articles/28515704603666-Connect-monday-MCP-with-Claude)** - Connect with Claude Desktop
- **[Cursor Integration](https://support.monday.com/hc/en-us/articles/28583658774034-Connect-monday-MCP-with-Cursor)** - Integrate with Cursor IDE
- **[ChatGPT Integration](https://support.monday.com/hc/en-us/articles/29491695661458-Connect-monday-MCP-with-ChatGPT)** - Connect with ChatGPT
- **[MS Copilot Integration](https://support.monday.com/hc/en-us/articles/28584426338322-Connect-monday-MCP-with-Microsoft-Copilot-Studio)** - Integrate with Microsoft Copilot Studio
- **[Mistral Integration](https://support.monday.com/hc/en-us/articles/29643990370066-Connect-monday-MCP-with-Mistral-AI-s-le-Chat)** - Connect with Mistral AI's le Chat
- **[Ready-to-Use Prompts](https://support.monday.com/hc/en-us/articles/28608471371410-Ready-to-use-monday-MCP-prompts)** - Example prompts to get started

### Quick Setup with Hosted MCP

#### For Cursor

Simply add this to your MCP settings:

```json
{
  "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**