MCP Tools
Plans & Playbooks

list_my_playbook_steps

List the playbook steps assigned to you that are still open, across all running cycles, soonest due first.

Parameters

NameTypeRequiredDefaultDescription
team_idintegerYes—Team id to act in (from initialize instructions or get_current_user_info). Required on external MCP; optional in bound sessions.
due_bystringNo—YYYY-MM-DD. Only steps due on or before this date (overdue included). Omit for all open steps.
run_idintegerNo—Only steps of this running playbook.
owner_namestringNo—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.