Monday.com MCP Server

Instructions

Implementation Reference

• src/mcp_server_monday/board.py:76-97 (handler)

  Core handler function that executes the Monday.com board creation using the MondayClient API, including validation of board kind and returning the new board ID.

  async def handle_monday_create_board(
      monday_client: MondayClient, board_name: str, board_kind: str = "public"
  ) -> list[types.TextContent]:
      """
      Create a new Monday.com board.
  
      Args:
          monday_client (MondayClient): The Monday.com client.
          board_name (str): The name of the board.
          board_kind (str): The kind of board to create. Must be one of "public" or "private". Defaults to "public".
      """
      actual_board_kind = BoardKind(board_kind)
      board = monday_client.boards.create_board(
          board_name=board_name, board_kind=actual_board_kind
      )
      return [
          types.TextContent(
              type="text",
              text=f"Created monday board {board_name} of kind {board_kind}. ID of the new board: {board['data']['create_board']['id']}",
          )
      ]

• src/mcp_server_monday/fastmcp_server.py:92-107 (registration)

  MCP tool registration using @mcp.tool(), defining input schema via type hints and docstring, wrapping the handler with client initialization and error handling.

  @mcp.tool()
  async def monday_create_board(boardName: str, boardKind: Optional[str] = None) -> str:
      """Create a new Monday.com board.
  
      Args:
          boardName: Name of the Monday.com board to create.
          boardKind: Kind of the Monday.com board to create (public, private, shareable). Default is public.
      """
      try:
          client = get_monday_client()
          result = await handle_monday_create_board(
              boardName, boardKind or "public", client
          )
          return result[0].text
      except Exception as e:
          return f"Error creating board: {e}"

• src/mcp_server_monday/fastmcp_server.py:11-12 (registration)

  Import of the handler function from board.py into the FastMCP server module.

  from mcp_server_monday.board import (
      handle_monday_create_board,