Use this tool to find boards, documents, or folders in your monday.com account by keyword. You can scope the search to specific workspaces using workspaceIds. Results are paginated and capped at 20 per page.

This tool is scoped to three content types: BOARD, DOCUMENTS, and FOLDERS. For other lookups — users and teams, workspaces, items and groups — use the dedicated tools (list_users_and_teams, list_workspaces, get_board_items_page, get_board_info).

🚧
IDs returned by this tool are prefixed with the object type (e.g., board-18394529013, doc-10069112255, folder-19028717). Strip the prefix before passing an ID to any other tool. For example, pass 18394529013 — not board-18394529013 — to get_board_info.

Parameters

Parameter	Type	Required	Description
searchType	`string`	Yes	The type of objects to search. One of `BOARD`, `DOCUMENTS`, or `FOLDERS`.
searchTerm	`string`	No	The keyword to search for. Omit or pass an empty string to return all objects of the given type.
limit	`number`	No	Number of results to return per page. Maximum and default is `20`.
page	`number`	No	Page number to return, starting at 1. Defaults to `1`.
workspaceIds	`array`	No	Array of workspace IDs to scope the search. Only pass this when you want to restrict results to specific workspaces.

Examples

Search for boards by keyword

Find boards containing "test" in workspace 12406666:

{
  "searchType": "BOARD",
  "searchTerm": "test",
  "limit": 5,
  "workspaceIds": [12406666]
}

The tool returned 5 matching boards. Each result includes a prefixed id (e.g., "board-18394529013") and a title. Strip the board- prefix to get 18394529013, which you can pass directly to get_board_info or other tools.

Search for documents by keyword

Find documents containing "MCP" in workspace 12406666:

{
  "searchType": "DOCUMENTS",
  "searchTerm": "MCP",
  "workspaceIds": [12406666]
}

Results include document IDs in doc-<id> format. Strip the doc- prefix before passing to read_docs.

List all folders in a workspace

{
  "searchType": "FOLDERS",
  "searchTerm": "",
  "workspaceIds": [12406666]
}

The tool returned folders with IDs like "folder-19028717". Strip the folder- prefix before passing to tools that accept folder IDs.

Programmatic equivalent

Use the GraphQL API to achieve the same result for board searches:

query {
  boards(
    workspace_ids: [12406666]
    limit: 5
  ) {
    id
    name
    url
  }
}

For full documentation, see Boards.