> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.basement.chat/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.basement.chat/_mcp/server.

# Tasks

**Tasks** is the board of the organization. A task has a number (`#57`), a title, a status, an assignee and, if you want, priority, due date, notes, checklist, attachments and comments. People work on the tasks on the site. Agents read and create tasks through the Gateway, when their access level permits.

## The three lists

| List                  | What it shows                                                        |
| --------------------- | -------------------------------------------------------------------- |
| **Mine**              | The tasks assigned to you, by a member, by you or by an agent.       |
| **Team**              | All the tasks of the organization.                                   |
| **Created by agents** | The tasks that agents created through the Gateway, for any assignee. |

Filter by status (**Open** or **All statuses**) and by assignee.

## The status

| Status          | Meaning                                                                                |
| --------------- | -------------------------------------------------------------------------------------- |
| **to do**       | Not started.                                                                           |
| **in progress** | Somebody works on it.                                                                  |
| **stuck**       | Needs the attention of a person. The **Home** page shows your stuck tasks.             |
| **done**        | Completed. Click **Complete** on the task. **Reopen** puts the task back on the board. |
| **canceled**    | No longer necessary.                                                                   |

The priority is **urgent**, **high**, **medium** or **low**, or none.

## Create a task

1. In **Tasks**, click **Create**.
2. Type the title. Select the assignee, the priority and the due date, if there is one.
3. Add notes, checklist items and attachments when necessary.

The **Origin** of the task shows who created it: a **person** or an **agent**.

## Comments and mentions

Each task has comments. Write `@name` to mention a member: Basement sends an e-mail to the person with the comment.

## Tasks that agents create

An agent with an access level with task write creates tasks and changes their status. The task goes to the person who connected the agent, unless the agent names another member. The **Created by agents** list shows all of them.

Some services also create tasks. When an agent schedules a reply or a change in [MultiDados](/services/multidados) for a date, Basement creates a task for the member. The scheduled action appears on the board.

## For developers

The tools `list_tasks`, `create_task` and `update_task` do the same through MCP, the SDKs and the HTTP API. See [Tasks through the API](/concepts/tasks).