mcpengine/servers/monday/TOOLS_SUMMARY.md

Monday.com MCP Server - Tools Summary

Overview

Total Tools: 60 (Target: 50-65 ✅)

All tools follow the naming convention: monday_verb_noun

---

1. Board Tools (7 tools) - src/tools/boards.ts

• monday_list_boards - List all boards with filters (state, kind, workspace)
• monday_get_board - Get single board with full details
• monday_create_board - Create new board (with template support)
• monday_update_board - Update board attributes (name, description, communication)
• monday_delete_board - Permanently delete a board
• monday_archive_board - Archive a board (reversible)
• monday_duplicate_board - Duplicate board with/without items

---

2. Item Tools (13 tools) - src/tools/items.ts

• monday_list_items - List items with cursor pagination
• monday_get_item - Get single item with full details
• monday_create_item - Create new item with column values
• monday_update_item - Update multiple column values at once
• monday_delete_item - Permanently delete an item
• monday_move_item_to_group - Move item to different group (same board)
• monday_move_item_to_board - Move item to different board
• monday_duplicate_item - Duplicate item with/without updates
• monday_archive_item - Archive an item (reversible)
• monday_create_subitem - Create subitem under parent
• monday_list_subitems - List all subitems of parent
• monday_clear_item_updates - Clear all updates from item
• monday_change_item_name - Change item name

---

3. Column Tools (8 tools) - src/tools/columns.ts

• monday_list_columns - List all columns in a board
• monday_get_column - Get single column details
• monday_create_column - Create new column with type
• monday_update_column - Update column metadata
• monday_delete_column - Delete column from board
• monday_change_column_value - Change single column value (complex types)
• monday_change_simple_column_value - Change simple text column value
• monday_change_multiple_column_values - Change multiple column values at once

---

4. Group Tools (7 tools) - src/tools/groups.ts

• monday_list_groups - List all groups in a board
• monday_get_group - Get single group with items
• monday_create_group - Create new group with positioning
• monday_update_group - Update group attributes (title, color, position)
• monday_delete_group - Delete a group
• monday_duplicate_group - Duplicate group with items
• monday_archive_group - Archive a group (reversible)

---

5. Update Tools (7 tools) - src/tools/updates.ts

• monday_list_updates - List all updates (activity) for item
• monday_get_update - Get single update with details
• monday_create_update - Create update/comment (supports HTML, replies)
• monday_delete_update - Delete an update
• monday_like_update - Like/unlike an update
• monday_list_replies - List all replies to an update
• monday_edit_update - Edit existing update body

---

6. User Tools (3 tools) - src/tools/users.ts

• monday_list_users - List all users with filters (kind, active status)
• monday_get_user - Get single user with full details
• monday_get_current_user - Get authenticated user details

---

7. Team Tools (2 tools) - src/tools/teams.ts

• monday_list_teams - List all teams with members
• monday_get_team - Get single team with member details

---

8. Workspace Tools (3 tools) - src/tools/workspaces.ts

• monday_list_workspaces - List all workspaces (open/closed)
• monday_get_workspace - Get single workspace with subscribers
• monday_create_workspace - Create new workspace (open/closed)

---

9. Folder Tools (5 tools) - src/tools/folders.ts

• monday_list_folders - List all folders in workspace
• monday_get_folder - Get single folder with children
• monday_create_folder - Create new folder (supports nesting)
• monday_update_folder - Update folder name/color
• monday_delete_folder - Delete a folder

---

10. Webhook Tools (3 tools) - src/tools/webhooks.ts

• monday_create_webhook - Create webhook for board events
• monday_delete_webhook - Delete a webhook
• monday_list_webhooks - List all webhooks for board

Supported Events:

• create_item, change_column_value, change_status_column_value
• change_specific_column_value, create_update, delete_update
• item_archived, item_deleted, item_moved_to_group
• item_restored, subitem_created

---

11. Automation Tools (2 tools) - src/tools/automations.ts

• monday_list_automations - List all automations for board
• monday_get_automation - Get single automation details

---

Technical Details

All Requests Use GraphQL

• Single endpoint: https://api.monday.com/v2
• POST requests with query + variables
• Complexity-based rate limiting

Pagination

• Cursor-based: items_page (recommended for large datasets)
• Page-based: limit + page parameters
• Max limit: typically 100

Column Values

• Stored as JSON strings
• Format varies by column type:
  • Text: {text: "value"}
  • Status: {index: 0, label: "Done"}
  • Date: {date: "2024-01-15", time: "10:30:00"}
  • People: {personsAndTeams: [{id: 123, kind: "person"}]}
  • etc.

Input Validation

• All tools use Zod schemas for type-safe input validation
• Clear error messages for invalid inputs

---

Files Created

1. ✅ src/tools/boards.ts (7 tools)
2. ✅ src/tools/items.ts (13 tools)
3. ✅ src/tools/columns.ts (8 tools)
4. ✅ src/tools/groups.ts (7 tools)
5. ✅ src/tools/updates.ts (7 tools)
6. ✅ src/tools/users.ts (3 tools)
7. ✅ src/tools/teams.ts (2 tools)
8. ✅ src/tools/workspaces.ts (3 tools)
9. ✅ src/tools/folders.ts (5 tools)
10. ✅ src/tools/webhooks.ts (3 tools)
11. ✅ src/tools/automations.ts (2 tools)
12. ✅ src/tools/index.ts (aggregator + executor)

---

TypeScript Compilation

✅ PASSED - npx tsc --noEmit runs without errors

All tools ready for integration into the MCP server!