@mondaydotcomorg/agent-toolkit

@mondaydotcomorg/agent-toolkit

A powerful toolkit for building AI agents that interact with the monday.com API. This package provides a set of tools and utilities to help you create AI-powered integrations with monday.com through Model Context Protocol (MCP) implementation.

Installation

npm install @mondaydotcomorg/agent-toolkit

Subpath Exports

The package provides several modular components that can be imported separately:

• @mondaydotcomorg/agent-toolkit/mcp - MCP server implementation
• @mondaydotcomorg/agent-toolkit/core - Core utilities and base classes
• @mondaydotcomorg/agent-toolkit/openai - OpenAI integration

Available Tools

The toolkit includes several pre-built tools for common monday.com operations, organized by functionality:

Item Operations

• CreateItemTool - Create a new item in a monday.com board
• DeleteItemTool - Delete an item from a board
• GetBoardItemsPageTool - Get items by board id and apply filters
• CreateUpdateTool - Create a new update on a specific item
• ChangeItemColumnValuesTool - Change the column values of an item in a monday.com board
• MoveItemToGroupTool - Move an item to a group in a monday.com board

Board Operations

• CreateBoardTool - Create a monday.com board
• GetBoardSchemaTool - Get board schema (columns and groups) by board id
• CreateGroupTool - Create a new group in a monday.com board
• CreateColumnTool - Create a new column in a monday.com board
• DeleteColumnTool - Delete a column from a monday.com board

WorkForms Operations

• CreateFormTool - Create a monday.com form
• GetFormTool - Get a form by its token, found in the form's URL
• UpdateFormTool - Update a monday.com form, including updating the form's feature settings, appearance settings, accessibility settings, title, description, question order, form tags, and form password
• FormQuestionsEditorTool - Create, update, or delete a question in a monday.com form

Account Operations

• ListUsersAndTeams - Get users or teams, either by ids, names or by searching the account

Workspace Operations

• ListWorkspaceTool - List workspaces available to the user, prioritizing workspaces where the user is a member

Dynamic API Tools

• AllMondayApiTool - Execute any monday.com API operation by generating GraphQL queries and mutations dynamically
• GetGraphQLSchemaTool - Fetch the monday.com GraphQL schema structure including query and mutation definitions
• GetTypeDetailsTool - Get detailed information about a specific GraphQL type from the monday.com API schema

Development

A Cursor skill is available at .cursor/skills/agent-toolkit-api-tools/SKILL.md with detailed guidance on creating and modifying platform API tools, including the GraphQL codegen pipeline, tool registration, and version bumping.

Usage