list_my_playbook_steps
List the playbook steps assigned to you that are still open, across all running cycles, soonest due first.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
team_id | integer | Yes | — | Team id to act in (from initialize instructions or get_current_user_info). Required on external MCP; optional in bound sessions. |
due_by | string | No | — | YYYY-MM-DD. Only steps due on or before this date (overdue included). Omit for all open steps. |
run_id | integer | No | — | Only steps of this running playbook. |
owner_name | string | No | — | Return the open steps owned by this typed owner name (an agent, or anyone who is not a team member), matched case-insensitively, instead of the steps assigned to you. Get the spelling from list_playbook_owner_names. |
Input Schema
{
"type": "object",
"required": [
"team_id"
],
"properties": {
"due_by": {
"type": "string",
"description": "YYYY-MM-DD. Only steps due on or before this date (overdue included). Omit for all open steps."
},
"run_id": {
"type": "integer",
"description": "Only steps of this running playbook."
},
"team_id": {
"type": "integer",
"minimum": 1,
"description": "Team id to act in (from initialize instructions or get_current_user_info). Required on external MCP; optional in bound sessions."
},
"owner_name": {
"type": "string",
"description": "Return the open steps owned by this typed owner name (an agent, or anyone who is not a team member), matched case-insensitively, instead of the steps assigned to you. Get the spelling from list_playbook_owner_names."
}
}
}Output Schema
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "content, checklist or action; only in owner_name mode."
},
"stage": {
"type": "string"
},
"title": {
"type": "string"
},
"prompt": {
"type": [
"string",
"null"
]
},
"run_id": {
"type": "integer"
},
"due_date": {
"type": [
"string",
"null"
]
},
"due_time": {
"type": [
"string",
"null"
],
"description": "HH:MM time of day, only in owner_name mode."
},
"link_url": {
"type": "string"
},
"plan_uuid": {
"type": "string",
"format": "uuid"
},
"cycle_name": {
"type": "string"
},
"owner_name": {
"type": "string",
"description": "The typed owner name, only in owner_name mode."
},
"description": {
"type": [
"string",
"null"
]
},
"cycle_link_url": {
"type": "string"
}
}
}
},
"itemsTotal": {
"type": "integer"
}
}
}Instructions
List the playbook steps assigned to you that are still open (not Complete or Dismissed), across all running playbooks, soonest due first. Steps with no due date come last. Pass owner_name to list the open steps owned by a typed owner name instead (matched case-insensitively across the team's running playbooks). Read-only.
When to use: the daily "what do I need to do" check. For example, pass due_by as today's date to find anything due or overdue, such as a step that says to submit a press release. Then read the step in context with get_playbook_cycle.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
team_id |
integer | Yes* | Team ID to act in (required on external MCP; optional in bound sessions) |
due_by |
string | No | YYYY-MM-DD. Only steps due on or before this date; overdue steps are included. Omit for all open steps |
run_id |
integer | No | Only steps of this running playbook |
owner_name |
string | No | Return the open steps owned by this typed owner name (an agent, or anyone who is not a team member), matched case-insensitively, instead of steps assigned to you. Get the exact spelling from list_playbook_owner_names |
Output: items and itemsTotal. Each item has:
| Field | Type | Description |
|---|---|---|
plan_uuid |
string | The step's plan. Pass to get_plan |
title, description |
string | What the step is |
prompt |
string | null | The step's instructions |
stage |
string | The step's current stage |
due_date |
string | null | YYYY-MM-DD |
run_id, cycle_name |
integer, string | The cycle the step belongs to |
cycle_link_url |
string | Opens the cycle in the Marcora web app |
link_url |
string | Opens the step in the Marcora web app |
In owner_name mode each item also carries due_time, owner_name, and kind.
Example prompts:
- "What do I need to do today?"
- "What's due or overdue this week in my playbook cycles?"
- "List my open steps in the launch cycle"
Links: present link_url to the user exactly as returned — copy it character for character. Never retype, shorten, or rebuild a link or the IDs inside it.