Tool

List ideas

List the workspace's ideas, most recently updated first, optionally by group, tag, platform, assignee or due date, or the archived ones. Items carry an excerpt; use get_idea for the full body.

POSTtools.readFree

POST/openapi/v1/tools/list_ideas

Call it

curl -X POST https://api.cuekoo.com/openapi/v1/tools/list_ideas \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

The MCP tool is named cuekoo_list_ideas. Arguments and results are identical to the REST call.

Arguments

Send a JSON object with these fields. Scope: tools.read.

Name	Type	Required	Description
`archived`	`boolean`	Optional	List archived ideas instead of the board
`assignee_user_id`	`string`	Optional
`cursor`	`string`	Optional
`due_from`	`string`	Optional	YYYY-MM-DD, inclusive
`due_to`	`string`	Optional	YYYY-MM-DD, inclusive
`group`	`string`	Optional	Board group name
`limit`	`integer`	Optional	1 to 50, default 20
`platform`	`string`	Optional	tiktok, instagram or youtube
`tag`	`string`	Optional	Tag name

Response

Name	Type	Required
`items`	`object[] \| null`	Required
`items[].archived`	`boolean`	Required
`items[].assignee`	`object \| null`	Required
`items[].assignee.display_name`	`string`	Required
`items[].assignee.id`	`string`	Required
`items[].due_date`	`string \| null`	Required
`items[].excerpt`	`string`	Required
`items[].group_id`	`string`	Required
`items[].id`	`string`	Required
`items[].platforms`	`string[] \| null`	Required
`items[].post_count`	`integer`	Required
`items[].tags`	`object[] \| null`	Required
`items[].tags[].color`	`string`	Required
`items[].tags[].id`	`string`	Required
`items[].tags[].name`	`string`	Required
`items[].title`	`string`	Required
`items[].updated_at`	`string`	Required
`items[].version`	`integer`	Required
`next_cursor`	`string`	Required

A call returns the Tool's output object at HTTP 200. Failures use the error envelope.

Credits

This Tool is free. It does not reserve or spend credits.