This repository provides an open framework for integrating AI agents with monday.com, a work operating system. It offers tools for developers to securely connect AI agents to structured data, enable actions, and provide context for decision-making within monday.com workflows, targeting AI assistant builders and custom integration developers.

How It Works

The project utilizes the Model Context Protocol (MCP) to facilitate agent-work OS interaction. It offers a plug-and-play MCP server (@mondaydotcomorg/monday-api-mcp) and an agent toolkit (@mondaydotcomorg/agent-toolkit) for both OpenAI and MCP implementations. This approach abstracts the complexities of the monday.com API, allowing agents to perform operations like creating items, managing boards, and updating statuses via a structured protocol.

Quick Start & Requirements

• Install/Run: Configure MCP clients (e.g., Claude Desktop, Cursor) with provided JSON snippets, specifying the monday-api-mcp command with your monday.com API token.
• Prerequisites: Node.js v20+, NPM v5.2.0+, a monday.com account, and a monday.com API token.
• Setup: Minimal setup time, primarily involving API token generation and client configuration.
• Docs: monday API MCP Documentation, Agent Toolkit Documentation, monday.com API Reference.

Highlighted Details

• Dynamic API Tools (Beta): Enables agents to access the full monday.com GraphQL API, allowing custom queries and schema exploration.
• Hosted MCP Service: Offers a simpler setup via OAuth or authorization headers, removing the need to manage a local server.
• Tool Categories: Provides pre-defined tools for Item Operations, Board Operations, and Account Operations.
• Security: Supports API token authentication via command-line arguments or environment variables, with recommendations for secure practices.

Maintenance & Community

• Maintained by the monday.com AI team.
• Community support via GitHub Issues and Discussions.

Licensing & Compatibility

• Licensed under the MIT License.
• Uses the monday.com API, subject to monday.com's Developer Terms. Compatible with commercial use as per MIT license, but API usage is governed by monday.com's terms.

Limitations & Caveats

Dynamic API Tools are in beta and require full API access, not being compatible with read-only mode. The project relies on the monday.com API, meaning its capabilities are tied to the features and stability of that platform.