# get_schedule_capacity (/docs/build/mcp-reference/get_schedule_capacity)

{/* GENERATED by scripts/generate-mcp-reference.mjs from the MCP server tools/list. Do not edit. */}

| Group | Access | MCP name |
| --- | --- | --- |
| Schedule | Read-only | `get_schedule_capacity` |

## Description [#description]

The description the MCP server sends to the model, word for word. Its rules apply to every call.

> Check how many more notes the user is allowed to schedule on their current plan. Returns maxScheduledNotes (the plan limit), currentScheduledCount, remaining (how many more they may schedule right now), and unlimited (true = the user has the Unlimited Schedules addon and there is no limit). ALWAYS call this before schedule_notes or schedule_notes_with_custom_dates, and NEVER schedule more notes than `remaining` unless unlimited is true.

## Arguments [#arguments]

This tool takes no arguments.

## Example call [#example-call]

The smallest valid request: required arguments only, with placeholder values.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_schedule_capacity",
    "arguments": {}
  }
}
```

## Result [#result]

The result has `structuredContent` that matches this schema. The same data is also in `content` as JSON text.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `currentScheduledCount` | `number` | Yes |  |
| `maxScheduledNotes` | `number` | Yes |  |
| `message` | `string` | Yes |  |
| `remaining` | `number` | Yes |  |
| `unlimited` | `boolean` | Yes |  |

## Annotations [#annotations]

| Hint | Value |
| --- | --- |
| `readOnlyHint` | `true` |
| `destructiveHint` | `false` |
| `openWorldHint` | `false` |

The full input and output JSON Schemas for every tool are in [/mcp-tools.json](/mcp-tools.json).