mcp monday ts

MCP Server for the Monday.com API, enabling board management, item creation, workspace organization, and bulk operations.

Features

• Intelligent Item Creation: Support for both standard and demo data item creation
• Bulk Operations: Create multiple items efficiently with a single command
• Workspace Management: List and manage workspaces and boards
• Comprehensive Error Handling: Clear error messages for common API issues
• Type Safety: Built with TypeScript for reliable operations

Tools

1. list_boards

2. List all boards in your Monday.com workspace

3. Returns: List of boards with details

4. get_board

5. Get detailed information about a specific board

6. Inputs:
   • boardId (number): The ID of the board to fetch

7. Returns: Board details including columns and items

8. get_items

9. Get all items from a specific board

10. Inputs:
    • boardId (number): The ID of the board to fetch items from

11. Returns: List of items with their column values

12. get_workspaces

13. List all workspaces in your Monday.com account

14. Returns: List of workspaces

15. get_workspace

16. Get detailed information about a specific workspace

17. Inputs:
    • workspaceId (number): The ID of the workspace to fetch

18. Returns: Workspace details

19. get_item

20. Get detailed information about a specific item

21. Inputs:
    • itemId (number): The ID of the item to fetch

22. Returns: Item details with column values

23. get_boards

24. Get all boards in a specific workspace

25. Inputs:
    • workspaceId (number): The ID of the workspace

26. Returns: List of boards in the workspace

27. create_item

28. Create a new item in a board

29. Inputs:
    • boardId (number): The ID of the board
    • itemName (string): Name of the new item
    • groupId (optional string): Group to create the item in
    • columnValues (optional object): Values for item columns

30. Returns: Created item details

31. delete_item

32. Delete an item from a board

33. Inputs:
    • itemId (number): The ID of the item to delete

34. Returns: Deletion confirmation

35. create_item_with_demo

    • Create a new item with demo data
    • Inputs:
    • boardId (number): The ID of the board
    • columnIds (optional string[]): Specific columns to fill
    • Returns: Created item with demo data

36. create_multiple_items

    • Create multiple items in a board
    • Inputs:
    • boardId (number): The ID of the board
    • count (number): Number of items to create
    • isDemo (optional boolean): Use demo data
    • Returns: First item details and creation status

37. create_remaining_items

    • Complete bulk item creation
    • Inputs:
    • boardId (number): The ID of the board
    • count (number): Number of remaining items
    • startIndex (number): Starting index for numbering
    • isDemo (optional boolean): Use demo data
    • Returns: Creation confirmation

Setup

Monday.com API Token

1. Go to your Monday.com account settings
2. Navigate to the 'Developer' section
3. Generate a new API token with appropriate permissions
4. Copy the generated token

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "monday": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "MONDAY_API_TOKEN", "mcp/monday"],
      "env": {
        "MONDAY_API_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Build

Docker build:

docker build -t mcp/monday .

Testing

Test the server locally:

docker run -it --rm -e MONDAY_API_TOKEN=<your_token> mcp/monday

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.