DashboardsWriteDo not retry automatically

Attach widget

attach_widget

Pin an existing widget onto a dashboard (appends a placement + grid cell). The grid is 12 columns: KPIs read best 3 wide, charts 6 wide (pairs), tables 12 wide. Without an explicit layout the cell is appended below existing rows at column 0 — pass layout to compose a real grid, or build the whole dashboard with compose_dashboard instead.

Parameters

Parameter	Type	Required	Description
`dashboardId`	string	required	Input for dashboardId.
`widgetId`	string	required	Input for widgetId.
`size`	"s" \| "m" \| "l" \| "full"	optional	s \| m \| l \| full
`layout`	object	optional	Explicit grid cell; otherwise appended below existing rows.

Example call

The tool call an MCP client sends (required arguments shown with placeholder values).

{
  "tool": "attach_widget",
  "arguments": {
    "dashboardId": "dashboardId_123",
    "widgetId": "widgetId_123"
  }
}

Use this tool in

Claude Code Claude Desktop Claude Cowork ChatGPT Cursor Windsurf VS Code Copilot OpenClaw Gemini Hermes Agent

Related Dashboards tools

List folderslist_foldersList folders in the workspace.Get folderget_folderGet one folder by id.Create foldercreate_folderCreate a folder to organize dashboards, widgets, and queries.Update folderupdate_folderPartially update a folder (name, icon, color, order, parent).

← All tools