---
name: "projects_board"
area: "projects"
title: "See a project's board"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/projects_board"
mcp_server: "https://api.conecto.chat/mcp/projects"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/projects/projects_board"
---

# See a project's board (`projects_board`)

A project as a board: each status with its tasks in order.

A project as a board: each status with its tasks in order (finished and canceled ones only if asked).

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

Someone asks how a project stands.

## Say this to your agent

> Show me the autumn sale board.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `project` | string | yes | A project's key ("WEB") or name. 1 to 80 characters. |  |  |
| `include_finished` | boolean | no |  |  | `false` |
| `per_status` | integer | no | 1 to 100. |  | `50` |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `projects_board` on the MCP server `https://api.conecto.chat/mcp/projects` with these arguments:

```json
{
  "project": "SALE"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/projects_board \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"project": "SALE"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "projects_board",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "project": "SALE",
    "name": "Autumn sale",
    "columns": [
      {
        "status": "Backlog",
        "kind": "backlog",
        "count": 0,
        "tasks": []
      },
      {
        "status": "To do",
        "kind": "unstarted",
        "count": 5,
        "tasks": [
          {
            "task": "SALE-1",
            "task_id": 4101,
            "title": "Choose the sale prices with Luis",
            "status": "To do",
            "priority": "urgent",
            "assignee": "luis@halversoncycle.example",
            "labels": [
              "prices"
            ],
            "due_date": "2026-10-15",
            "parent": null,
            "updated_at": "2026-10-14T08:00:00+00:00"
          },
          {
            "task": "SALE-2",
            "task_id": 4102,
            "title": "Design the sale flyer",
            "status": "To do",
            "priority": "high",
            "assignee": "luis@halversoncycle.example",
            "labels": [
              "print"
            ],
            "due_date": "2026-10-19",
            "parent": null,
            "updated_at": "2026-10-14T08:00:00+00:00"
          }
        ]
      }
    ]
  }
}
```

`result`: The project's key and name, and columns: each status with its tasks (number, title, priority, assignee, labels, due date).

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_found` | 404 | No project has that key or name. | Call projects_list and use one of its keys. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [projects_create](https://conecto.chat/tools/projects/projects_create.md): Creates a board of tasks with a short key that numbers them, and its own statuses if you like. $0.001 a call.
- [projects_list](https://conecto.chat/tools/projects/projects_list.md): Every project with how many tasks are in each status. Free up to 1,000,000 reads a month.
- [tasks_create](https://conecto.chat/tools/projects/tasks_create.md): Adds a task to a project, numbered like SALE-13, with status, priority, assignee, labels, due date, CRM links or a parent. $0.01 a call.
- [tasks_update](https://conecto.chat/tools/projects/tasks_update.md): Changes a task: status, assignee, priority, labels, due date, title, description, CRM links or its place in the column. $0.01 a call.
- [tasks_list](https://conecto.chat/tools/projects/tasks_list.md): Open tasks across projects or in one, most urgent first, filtered by status, assignee, label, priority, due date or words. Free up to 1,000,000 reads a month.
- [tasks_get](https://conecto.chat/tools/projects/tasks_get.md): One task in full: description, links, subtasks, comments and history. Free up to 1,000,000 reads a month.
- [tasks_comment](https://conecto.chat/tools/projects/tasks_comment.md): Adds a comment in Markdown to a task's thread. $0.01 a call.
- [tasks_delete](https://conecto.chat/tools/projects/tasks_delete.md): Deletes a task and its subtasks for good. Free.