Create Task
create_taskCreate tasks with team or private scope, assign to humans or AI, set due dates and priorities, and link to customers, contacts, or other entities.
Instructions
Create a new task. Scope 'org' (default) is visible to all team members; 'personal' is private to the creator. Use assigned_to with a FOUNDERS_OS_USER_ID for human assignment, or '@claude' / '@gpt' for AI assignment. Optionally link to any FounderOS entity (customer, contact, transaction, etc.) at creation time. If the response contains a conflict field, the task was NOT created. Present all options to the user using an interactive chooser (AskUserQuestion) if available, then retry with the selected date.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Tags for filtering and grouping (e.g. ['Q2', 'fundraising']). | |
| links | No | Entities to link this task to at creation time. | |
| scope | No | 'org' (default) for team-visible; 'personal' for private. | |
| title | Yes | What needs to be done. | |
| status | No | Task status. Defaults to 'todo'. | |
| due_date | No | Due date (YYYY-MM-DD). | |
| priority | No | Priority level. Defaults to 'medium'. | |
| assigned_to | No | Who to assign this to. Use a FOUNDERS_OS_USER_ID for a human, or '@claude' / '@gpt' for AI. A task takes exactly one assignee by design: the single accountable owner, the 'one neck to grab' (ONTG). This is deliberate, not a limitation - work split across several names tends to get done by no one. If several people are involved, still set one owner here and name the others in the description (or tag people you are waiting on with an @person tag). | |
| description | No | Additional details or context. | |
| due_date_day | No | Expected day of the week for due_date. If provided, the server validates it matches. Catches errors when converting 'due Thursday' to a date. Mismatch returns the correct day and nearby alternatives. | |
| blocked_reason | No | Required context when status is 'blocked'. | |
| blocked_by_task_id | No | UUID of a task that blocks this one. Sets status to 'blocked' automatically if not already set. |