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!