---
title: "Create Dashboard"
description: "Create an analytics dashboard."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Dashboard

Use the Speak AI MCP server tool `create_dashboard` to create an analytics
dashboard.

## What does it do?

Create an analytics dashboard. Only `title` is required: source defaults to the
whole workspace and dateRange to last30days. Add widgets by listing their types (the
MCP assigns ids and lays them out automatically), scope with source
(\{type:"folders",folderIds\} | \{type:"team"\} | \{type:"workspace"\}) and
dateRange (\{preset\}), and optionally group widgets into sections. Design guidance:
lead with a narrative widget as the first widget; group sections by the QUESTION
they answer, not by widget type; don't pad. Every widget earns its place (aim for
4-16 widgets on a full build); if something can't be expressed by the widget
catalog, put it in a narrative widget's focus instead of faking it. Call
`list_dashboard_widgets` first for the widget catalog, config vocabulary, design
rules, and full examples.

## Parameters

`create_dashboard` takes 10 parameters, 1 of them required.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `title` | string | Yes | Dashboard name, max 60 chars (the only required field) |
| `description` | string | No | Dashboard description, max 280 chars |
| `source` | object | No | Data source: \{type:"folders", folderIds:[...]\} \| \{type:"team"\} \| \{type:"workspace"\} |
| `dateRange` | object | No | Date range: strict preset only, no free-form start/end dates |
| `sections` | array of object | No | Optional named widget groups (tabs). Each references widgets by their explicit ids; widgets in no section form the implicit Overview group. |
| `widgets` | array of object | No | Widgets to place on the dashboard, in order (max 24). The MCP assigns ids and computes a tidy two-per-row grid layout matching the Speak UI unless you pass explicit id/layout. |
| `icon` | string | No | Icon identifier |
| `assignTo` | array of string | No | User ids, or group ids in the "\<groupId\> (G)" convention, to share view access with |
| `filters` | object | No | Field filters. filters.filterList is an array of \{ fieldName, fieldOperator?, fieldValue?: string[], fieldCondition? \}. Other keys pass through but only filterList is enforced. |
| `isDefault` | boolean | No | Make this the company default dashboard |

## Behaviour

The Speak AI MCP server publishes these behaviour hints for `create_dashboard`.

- Can change data in your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call can have an extra effect.
- Stays inside Speak AI. Does not reach other systems.

## Related

- [Dashboards](/mcp/tools/dashboards/) lists the rest of the Dashboards category.
- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/dashboards/create_dashboard/index.mdx