`monday_search_items`

Pack: monday · Endpoint: https://gateway.pipeworx.io/monday/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/monday_search_items for the schema, then POST the same URL with its arguments for the data.

Search for items across all boards by keyword. Returns matching items with ID, name, board name, and column values.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	Monday.com API token
`query`	string	yes	Search query text
`limit`	number	no	Number of results to return (default 20, max 50)

Example call

Arguments

{
  "_apiKey": "your-monday-api-key",
  "query": "urgent"
}

curl

curl -X POST https://gateway.pipeworx.io/monday/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"monday_search_items","arguments":{"_apiKey":"your-monday-api-key","query":"urgent"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('monday_search_items', {
  "_apiKey": "your-monday-api-key",
  "query": "urgent"
});

More examples

{
  "_apiKey": "your-monday-api-key",
  "query": "Q4 planning",
  "limit": 25
}

Response shape

Always returns: items

Field	Type	Description
`items`	array	Search results

Full JSON Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "Search results",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Item ID"
          },
          "name": {
            "type": "string",
            "description": "Item name"
          },
          "board": {
            "type": "object",
            "description": "Board information",
            "properties": {
              "id": {
                "type": "string",
                "description": "Board ID"
              },
              "name": {
                "type": "string",
                "description": "Board name"
              }
            }
          },
          "group": {
            "type": "object",
            "description": "Item group",
            "properties": {
              "id": {
                "type": "string",
                "description": "Group ID"
              },
              "title": {
                "type": "string",
                "description": "Group title"
              }
            }
          },
          "column_values": {
            "type": "array",
            "description": "Column values for the item",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Column ID"
                },
                "text": {
                  "type": "string",
                  "description": "Column value text"
                },
                "type": {
                  "type": "string",
                  "description": "Column type"
                }
              }
            }
          },
          "created_at": {
            "type": "string",
            "description": "Item creation timestamp"
          }
        }
      }
    }
  },
  "required": [
    "items"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "monday": {
      "url": "https://gateway.pipeworx.io/monday/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

monday_search_items