> For the complete documentation index, see [llms.txt](https://docs.autommate.com/userguide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools/schedules-search.md).

# schedules\_search — Read running schedules

**Declared contract — reviewed 21 October 2026.** This page describes the tool exposed by the Autom Mate New connection in the inspected 71-tool profile. It does not establish support on every build or prove runtime success. Check the active connection and [installed product version](https://docs.autommate.com/userguide/start-here/documentation-scope-and-product-versions.md). Historical examples retain their original observation dates. Logical tool names may have a client-specific namespace prefix.

Read running schedules and their next-run time. Use `automs_get` for recurrence details, the schedule summary and running state.

## Declared request signature

The following is the exposed 21 October declaration; request types do not define an exhaustive response schema.

```ts
declare const tools: { mcp__codex_apps__autom_mate_new_schedules_search(args: { cursor?: string; page_size?: number; query?: string; sort_by?: "autom_name" | "scheduled_at"; }): Promise<CallToolResult>; };
```

## Parameters

| Parameter   | Type                           | Required | Meaning                                                                                         |
| ----------- | ------------------------------ | -------- | ----------------------------------------------------------------------------------------------- |
| `query`     | string                         | No       | Schedule/Autom search value. Exact matching rules are not specified in the exposed description. |
| `sort_by`   | `autom_name` or `scheduled_at` | No       | Sort field.                                                                                     |
| `page_size` | number                         | No       | Requested page size.                                                                            |
| `cursor`    | string                         | No       | Returned pagination cursor.                                                                     |

## Minimal request

Replace the search placeholder with the intended name. The exposed description does not specify this query's exact matching rules.

```json
{
  "query": "<Hyperflow name>",
  "sort_by": "scheduled_at"
}
```

## Read the result

* Paused or disabled schedules are not included. An absent schedule is not proof that the Hyperflow has no schedule configured.
* A `scope_note` can restrict the results to Hyperflows created by the connected user. Preserve this limit when reporting the search.
* Documented collection examples for this tool do not contain `total`; do not require that field to process a valid result.
* A next-run time is schedule information, not evidence that the future run has started or will achieve its business result.
* For another page, keep the same filters and pass the returned cursor unchanged. Treat the cursor as opaque; stop when no continuation is returned. The first page need not be the complete result set.

## Permissions and retries

Read-only schedule lookup. It does not create, enable, disable or trigger schedules. Resolve access or lookup uncertainty before reporting that no schedule exists; do not run a Hyperflow to test a schedule without separate authorization.

## Present a requested result

When the user asked to see this result, pass the returned `result_ref` to `show_result` once for the final requested answer. Do not show cards for intermediate lookups. A result reference expires after 15 minutes; read again if it has expired. This presentation step neither executes nor verifies a business action.

## Continue

* Next tools: [`automs_search`](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools/automs-search) · [`automs_get`](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools/automs-get) · [`runs_search`](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools/runs-search).
* Workflow: [Inspection tool contracts](https://docs.autommate.com/userguide/mcp-and-ai-reference/inspection-tool-contracts.md).
* Worked reference: [Read platform summaries schedules and agent health](https://docs.autommate.com/userguide/mcp-and-ai-reference/read-platform-summaries-schedules-and-agent-health.md).
* [MCP tool reference](https://docs.autommate.com/userguide/mcp-and-ai-reference/tools).
