Monday.com

The Monday.com connector lets your workflows manage boards, items, updates, and workspaces through the Monday.com GraphQL API.

For the full API reference, see the Monday.com API documentation.

Connection setup

Get your API token

In Monday.com, click your avatar in the bottom-left corner and go to Developers > My Access Tokens. Copy your personal API token (or create a new one for your integration).

Add the connection in Spojit

Go to Connections in Spojit, click Add Connection, select Monday.com, and enter:

API Token: Your Monday.com API token

Monday.com uses a GraphQL API. All tools translate to GraphQL queries and mutations under the hood.

Tools

Boards

list-boards: List boards

number

default:"25"

Number of boards to return.

number

default:"1"

Page number for pagination.

number

Filter by workspace ID.

string

Filter by board type: public, private, or share.

Example request:

{
  "limit": 3
}

Example response:

{
  "data": {
    "boards": [
      {
        "id": "1234567890",
        "name": "Project Tracker",
        "state": "active",
        "board_kind": "public",
        "columns": [
          { "id": "status", "title": "Status", "type": "status" },
          { "id": "person", "title": "Owner", "type": "people" },
          { "id": "date4", "title": "Due Date", "type": "date" }
        ],
        "groups": [
          { "id": "new_group", "title": "To Do" },
          { "id": "group_2", "title": "In Progress" },
          { "id": "group_3", "title": "Done" }
        ]
      },
      {
        "id": "1234567891",
        "name": "Bug Reports",
        "state": "active",
        "board_kind": "public",
        "columns": [
          { "id": "status", "title": "Priority", "type": "status" },
          { "id": "text0", "title": "Description", "type": "text" }
        ],
        "groups": [
          { "id": "new_group", "title": "Open" },
          { "id": "group_2", "title": "Closed" }
        ]
      }
    ]
  }
}

get-board: Get a board by ID

Returns board details including columns and groups.

number

required

Board ID.

Example request:

{
  "id": 1234567890
}

Example response:

{
  "data": {
    "boards": [
      {
        "id": "1234567890",
        "name": "Project Tracker",
        "state": "active",
        "columns": [
          { "id": "status", "title": "Status", "type": "status" },
          { "id": "person", "title": "Owner", "type": "people" },
          { "id": "date4", "title": "Due Date", "type": "date" },
          { "id": "numbers", "title": "Story Points", "type": "numbers" }
        ],
        "groups": [
          { "id": "new_group", "title": "To Do" },
          { "id": "group_2", "title": "In Progress" },
          { "id": "group_3", "title": "Done" }
        ],
        "items_page": {
          "cursor": "MSw1LGl0ZW1faWQ...",
          "items": [
            {
              "id": "9876543210",
              "name": "Design new landing page",
              "column_values": [
                { "id": "status", "text": "Working on it", "value": "{\"index\":1}" },
                { "id": "date4", "text": "2024-07-15", "value": "{\"date\":\"2024-07-15\"}" }
              ]
            }
          ]
        }
      }
    ]
  }
}

Items

list-items: List items on a board

number

required

Board ID to list items from.

number

default:"25"

Number of items to return.

number

default:"1"

Page number for pagination.

string

Filter by group ID within the board.

Example request:

{
  "board_id": 1234567890,
  "limit": 2
}

Example response:

{
  "data": {
    "boards": [
      {
        "items_page": {
          "cursor": "MSw1LGl0ZW1faWQ...",
          "items": [
            {
              "id": "9876543210",
              "name": "Design new landing page",
              "column_values": [
                { "id": "status", "text": "Working on it", "value": "{\"index\":1}" },
                { "id": "person", "text": "Alice", "value": "{\"personsAndTeams\":[{\"id\":12345}]}" },
                { "id": "date4", "text": "2024-07-15", "value": "{\"date\":\"2024-07-15\"}" }
              ],
              "group": { "id": "group_2", "title": "In Progress" }
            },
            {
              "id": "9876543211",
              "name": "Write API documentation",
              "column_values": [
                { "id": "status", "text": "Done", "value": "{\"index\":2}" },
                { "id": "person", "text": "Bob", "value": "{\"personsAndTeams\":[{\"id\":12346}]}" },
                { "id": "date4", "text": "2024-07-10", "value": "{\"date\":\"2024-07-10\"}" }
              ],
              "group": { "id": "group_3", "title": "Done" }
            }
          ]
        }
      }
    ]
  }
}

get-item: Get an item by ID

Returns item details including column values.

number

required

Item ID.

Example request:

{
  "id": 9876543210
}

Example response:

{
  "data": {
    "items": [
      {
        "id": "9876543210",
        "name": "Design new landing page",
        "board": { "id": "1234567890", "name": "Project Tracker" },
        "column_values": [
          { "id": "status", "title": "Status", "text": "Working on it", "value": "{\"index\":1}", "type": "status" },
          { "id": "person", "title": "Owner", "text": "Alice", "value": "{\"personsAndTeams\":[{\"id\":12345}]}", "type": "people" },
          { "id": "date4", "title": "Due Date", "text": "2024-07-15", "value": "{\"date\":\"2024-07-15\"}", "type": "date" },
          { "id": "numbers", "title": "Story Points", "text": "5", "value": "\"5\"", "type": "numbers" }
        ],
        "updates": [
          {
            "id": "111222333",
            "text_body": "Mockups are ready for review",
            "created_at": "2024-07-08T10:30:00Z",
            "creator": { "id": "12345", "name": "Alice Johnson" }
          }
        ]
      }
    ]
  }
}

create-item: Create a new item

number

required

Board ID to create the item in.

string

required

Item name.

string

Group ID within the board. Uses the first group if not specified.

object

Column values as a JSON object. Keys are column IDs, values follow Monday.com column value format.

Example request:

{
  "board_id": 1234567890,
  "item_name": "Fix login button on mobile",
  "group_id": "new_group",
  "column_values": {
    "status": { "label": "Working on it" },
    "person": { "personsAndTeams": [{ "id": 12345, "kind": "person" }] },
    "date4": { "date": "2024-07-20" }
  }
}

Example response:

{
  "data": {
    "create_item": {
      "id": "9876543212",
      "name": "Fix login button on mobile"
    }
  }
}

update-item: Update an item's column values

number

required

Board ID the item belongs to.

number

required

Item ID.

object

required

Column values to update. Keys are column IDs.

Example request:

{
  "board_id": 1234567890,
  "id": 9876543210,
  "column_values": {
    "status": { "label": "Done" },
    "numbers": "8"
  }
}

Example response:

{
  "data": {
    "change_multiple_column_values": {
      "id": "9876543210",
      "name": "Design new landing page"
    }
  }
}

delete-item: Delete an item

number

required

Item ID.

Example request:

{
  "id": 9876543212
}

Example response:

{
  "data": {
    "delete_item": {
      "id": "9876543212"
    }
  }
}

Updates

create-update: Post an update on an item

number

required

Item ID to post the update on.

string

required

Update body text (HTML supported).

Example request:

{
  "item_id": 9876543210,
  "body": "Completed the design review. Moving to development next week."
}

Example response:

{
  "data": {
    "create_update": {
      "id": "111222334",
      "text_body": "Completed the design review. Moving to development next week."
    }
  }
}

Workspaces

list-workspaces: List workspaces

number

default:"25"

Number of workspaces to return.

number

default:"1"

Page number for pagination.

Example response:

{
  "data": {
    "workspaces": [
      {
        "id": "444555",
        "name": "Engineering",
        "kind": "open",
        "description": "Engineering team workspace"
      },
      {
        "id": "444556",
        "name": "Marketing",
        "kind": "open",
        "description": "Marketing campaigns and content"
      }
    ]
  }
}

Advanced

raw-graphql: Execute arbitrary GraphQL

Run any GraphQL query or mutation against the Monday.com API.

string

required

GraphQL query or mutation string.

object

GraphQL variables.

Example request:

{
  "query": "query { users { id name email } }"
}

Example response:

{
  "data": {
    "users": [
      {
        "id": "12345",
        "name": "Alice Johnson",
        "email": "alice@example.com"
      },
      {
        "id": "12346",
        "name": "Bob Williams",
        "email": "bob@example.com"
      }
    ]
  }
}

Overview

Integrations

Remote MCP Servers

Databases

Data Processing

Text and Strings

Numbers and Dates

Files and Media

Encoding and Validation

Developer Tools

Connection setup

Tools

Boards

Items

Updates

Workspaces

Advanced

​Connection setup

​Tools

​Boards

​Items

​Updates

​Workspaces

​Advanced

Connection setup

Tools

Boards

Items

Updates

Workspaces

Advanced