Views

Generated from the live tool catalog in packages/mcp/src/server.ts. Run pnpm mcp-docs in apps/docs to regenerate after changing a tool.

`list_views`

List your saved issue/project views.

Parameter	Type	Required	Description
`workspace`	`string`	no	Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace.

`create_view`

Create a saved view. Issue views require a team.

Parameter	Type	Required	Description
`name`	`string`	yes	View name
`kind`	`"issues" \| "projects"`	no	What the view lists, defaults to issues
`team`	`string`	no	Team key, required for issue views
`display`	`"list" \| "board"`	no	Display mode, defaults to list
`filters`	`object`	no	Filter object, defaults to {}
`sort`	`string \| null`	no	Sort key, or null for default
`favorite`	`boolean`	no	Whether the view is favorited
`workspace`	`string`	no	Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace.

`update_view`

Update a saved view you own. Only provided fields change.

Parameter	Type	Required	Description
`id`	`string`	yes	View id
`name`	`string`	no	View name
`favorite`	`boolean`	no	Whether the view is favorited
`display`	`"list" \| "board"`	no	Display mode
`filters`	`object`	no	Filter object
`workspace`	`string`	no	Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace.

`delete_view`

Delete a saved view you own.

Parameter	Type	Required	Description
`id`	`string`	yes	View id
`workspace`	`string`	no	Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace.

Read the baseline filters a built-in view opens with. Returns your own overrides and the workspace baselines; yours wins where both exist. viewKey is a base key (issues, my-work, projects, initiatives) or a team-scoped one, which is the base plus a colon and the team id: team-issues:TEAM_ID, team-cycles:TEAM_ID, team-projects:TEAM_ID.

Parameter	Type	Required	Description
`viewKey`	`string`	no	Limit to one view key
`workspace`	`string`	no	Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace.

`set_view_defaults`

Set what a built-in view opens with. Scope 'user' is your own starting point; scope 'workspace' is the baseline for everyone without an override and is admin only.

Parameter	Type	Required	Description
`viewKey`	`string`	yes	View key, e.g. my-work, or team-issues:TEAM_ID
`scope`	`"user" \| "workspace"`	no	Defaults to user
`filters`	`object`	no	Filter object matching the view's kind, e.g. { states: [...], assignees: [...] }
`sort`	`string \| null`	no	Sort key, or null for none
`display`	`string \| null`	no	Display mode, e.g. list, board, table
`grouping`	`string \| null`	no	Grouping key, or null for none
`hidden`	`string[]`	no	Sections the view opens with hidden
`workspace`	`string`	no	Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace.

`reset_view_defaults`

Clear a view default. Scope 'user' drops your override so the workspace baseline applies again; scope 'workspace' clears the baseline and is admin only.

Parameter	Type	Required	Description
`viewKey`	`string`	yes	View key
`scope`	`"user" \| "workspace"`	no	Defaults to user
`workspace`	`string`	no	Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace.