Skip to content

README.md

Latest commit

 

History

History
65 lines (42 loc) · 2.79 KB

README.md

File metadata and controls

65 lines (42 loc) · 2.79 KB

@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