linear

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

linear

Linear

MCP skill for linear. Provides 31 tools: get_attachment, create_attachment, delete_attachment, list_comments, save_comment, delete_comment, list_cycles, get_document, list_documents, create_document, update_document, extract_images, get_issue, list_issues, save_issue, list_issue_statuses, get_issue_status, list_issue_labels, create_issue_label, list_projects, get_project, save_project, list_project_labels, list_milestones, get_milestone, save_milestone, list_teams, get_team, list_users, get_user, search_documentation

面向Linear的MCP Skill。提供31种工具：get_attachment、create_attachment、delete_attachment、list_comments、save_comment、delete_comment、list_cycles、get_document、list_documents、create_document、update_document、extract_images、get_issue、list_issues、save_issue、list_issue_statuses、get_issue_status、list_issue_labels、create_issue_label、list_projects、get_project、save_project、list_project_labels、list_milestones、get_milestone、save_milestone、list_teams、get_team、list_users、get_user、search_documentation

Authentication

认证方式

This MCP server uses OAuth authentication. The OAuth flow is handled automatically by the MCP client. Tokens are persisted to

~/.mcp-skill/auth/

so subsequent runs reuse the same credentials without re-authenticating.

python

app = LinearApp()  # uses default OAuth flow

To bring your own OAuth provider, pass it via the

auth

argument:

python

app = LinearApp(auth=my_oauth_provider)

本MCP服务器采用OAuth认证方式。 OAuth流程由MCP客户端自动处理。令牌会持久化存储到

~/.mcp-skill/auth/

目录，因此后续运行时可复用相同凭证，无需重新认证。

python

app = LinearApp()  # uses default OAuth flow

若要使用自定义OAuth服务提供商，可通过

auth

参数传入：

python

app = LinearApp(auth=my_oauth_provider)

Dependencies

依赖项

This skill requires the following Python packages:

```
mcp-skill
```

Install with uv:

bash

uv pip install mcp-skill

Or with pip:

bash

pip install mcp-skill

本Skill需要以下Python包：

```
mcp-skill
```

使用uv安装：

bash

uv pip install mcp-skill

或使用pip安装：

bash

pip install mcp-skill

How to Run

运行方法

Important: Add

.agents/skills

to your Python path so imports resolve correctly:

python

import sys
sys.path.insert(0, ".agents/skills")
from linear.app import LinearApp

Or set the

PYTHONPATH

environment variable:

bash

export PYTHONPATH=".agents/skills:$PYTHONPATH"

Preferred: use
uv run
(handles dependencies automatically):

bash

PYTHONPATH=.agents/skills uv run --with mcp-skill python -c "
import asyncio
from linear.app import LinearApp

async def main():
    app = LinearApp()
    result = await app.get_attachment(id="example")
    print(result)

asyncio.run(main())
"

Alternative: use
python
directly (install dependencies first):

bash

pip install mcp-skill
PYTHONPATH=.agents/skills python -c "
import asyncio
from linear.app import LinearApp

async def main():
    app = LinearApp()
    result = await app.get_attachment(id="example")
    print(result)

asyncio.run(main())
"

重要提示： 将

.agents/skills

添加到Python路径，确保导入能正确解析：

python

import sys
sys.path.insert(0, ".agents/skills")
from linear.app import LinearApp

或设置

PYTHONPATH

环境变量：

bash

export PYTHONPATH=".agents/skills:$PYTHONPATH"

推荐方式：使用
uv run
（自动处理依赖）：

bash

PYTHONPATH=.agents/skills uv run --with mcp-skill python -c "
import asyncio
from linear.app import LinearApp

async def main():
    app = LinearApp()
    result = await app.get_attachment(id='example')
    print(result)

asyncio.run(main())
"

替代方式：直接使用
python
（需先安装依赖）：

bash

pip install mcp-skill
PYTHONPATH=.agents/skills python -c "
import asyncio
from linear.app import LinearApp

async def main():
    app = LinearApp()
    result = await app.get_attachment(id='example')
    print(result)

asyncio.run(main())
"

Available Tools

可用工具

get_attachment

Retrieve an attachment's content by ID.

Parameter	Type	Required	Description
id	`str`	Yes	Attachment ID

Example:

python

result = await app.get_attachment(id="example")

通过ID获取附件内容。

参数	类型	必填	描述
id	`str`	是	附件ID

示例：

python

result = await app.get_attachment(id='example')

create_attachment

Create a new attachment on a specific Linear issue by uploading base64-encoded content.

Parameter	Type	Required	Description
issue	`str`	Yes	Issue ID or identifier (e.g., LIN-123)
base64Content	`str`	Yes	Base64-encoded file content to upload
filename	`str`	Yes	Filename for the upload (e.g., 'screenshot.png')
contentType	`str`	Yes	MIME type for the upload (e.g., 'image/png', 'application/pdf')
title	`str`	No	Optional title for the attachment
subtitle	`str`	No	Optional subtitle for the attachment

Example:

python

result = await app.create_attachment(issue="example", base64Content="example", filename="example")

通过上传Base64编码内容，在指定Linear问题中创建新附件。

参数	类型	必填	描述
issue	`str`	是	问题ID或标识符（例如：LIN-123）
base64Content	`str`	是	待上传文件的Base64编码内容
filename	`str`	是	上传文件的文件名（例如：'screenshot.png'）
contentType	`str`	是	上传文件的MIME类型（例如：'image/png'、'application/pdf'）
title	`str`	否	附件的可选标题
subtitle	`str`	否	附件的可选副标题

示例：

python

result = await app.create_attachment(issue='example', base64Content='example', filename='example')

delete_attachment

Delete an attachment by ID

Parameter	Type	Required	Description
id	`str`	Yes	Attachment ID

Example:

python

result = await app.delete_attachment(id="example")

通过ID删除附件

参数	类型	必填	描述
id	`str`	是	附件ID

示例：

python

result = await app.delete_attachment(id='example')

list_comments

List comments for a specific Linear issue

Parameter	Type	Required	Description
issueId	`str`	Yes	Issue ID

Example:

python

result = await app.list_comments(issueId="example")

列出指定Linear问题的所有评论

参数	类型	必填	描述
issueId	`str`	是	问题ID

示例：

python

result = await app.list_comments(issueId='example')

save_comment

Create or update a comment on a Linear issue. If

id

is provided, updates the existing comment; otherwise creates a new one. When creating,

issueId

and

body

are required.

Parameter	Type	Required	Description
id	`str`	No	Comment ID. If provided, updates the existing comment
issueId	`str`	No	Issue ID (required when creating)
parentId	`str`	No	Parent comment ID (for replies, only when creating)
body	`str`	Yes	Content as Markdown

Example:

python

result = await app.save_comment(id="example", issueId="example", parentId="example")

在Linear问题中创建或更新评论。若提供

id

则更新现有评论，否则创建新评论。创建时需提供

issueId

和

body

。

参数	类型	必填	描述
id	`str`	否	评论ID。若提供则更新现有评论
issueId	`str`	否	问题ID（创建时必填）
parentId	`str`	否	父评论ID（仅创建回复时需提供）
body	`str`	是	Markdown格式的评论内容

示例：

python

result = await app.save_comment(id='example', issueId='example', parentId='example')

delete_comment

Delete a comment from a Linear issue

Parameter	Type	Required	Description
id	`str`	Yes	Comment ID

Example:

python

result = await app.delete_comment(id="example")

从Linear问题中删除评论

参数	类型	必填	描述
id	`str`	是	评论ID

示例：

python

result = await app.delete_comment(id='example')

list_cycles

Retrieve cycles for a specific Linear team

Parameter	Type	Required	Description
teamId	`str`	Yes	Team ID
type	`str`	No	Filter: current, previous, next, or all

Example:

python

result = await app.list_cycles(teamId="example", type="example")

获取指定Linear团队的迭代周期

参数	类型	必填	描述
teamId	`str`	是	团队ID
type	`str`	否	筛选条件：current（当前）、previous（上一个）、next（下一个）或all（全部）

示例：

python

result = await app.list_cycles(teamId='example', type='example')

get_document

Retrieve a Linear document by ID or slug

Parameter	Type	Required	Description
id	`str`	Yes	Document ID or slug

Example:

python

result = await app.get_document(id="example")

通过ID或别名获取Linear文档

参数	类型	必填	描述
id	`str`	是	文档ID或别名

示例：

python

result = await app.get_document(id='example')

list_documents

List documents in the user's Linear workspace

Parameter	Type	Required	Description
limit	`float`	No	Max results (default 50, max 250)
cursor	`str`	No	Next page cursor
orderBy	`str`	No	Sort: createdAt
query	`str`	No	Search query
projectId	`str`	No	Filter by project ID
initiativeId	`str`	No	Filter by initiative ID
creatorId	`str`	No	Filter by creator ID
createdAt	`str`	No	Created after: ISO-8601 date/duration (e.g., -P1D)
updatedAt	`str`	No	Updated after: ISO-8601 date/duration (e.g., -P1D)
includeArchived	`bool`	No	Include archived items

Example:

python

result = await app.list_documents(limit=1.0, cursor="example", orderBy="example")

列出用户Linear工作区中的所有文档

参数	类型	必填	描述
limit	`float`	否	最大结果数（默认50，上限250）
cursor	`str`	否	下一页游标
orderBy	`str`	否	排序方式：createdAt（创建时间）
query	`str`	否	搜索关键词
projectId	`str`	否	按项目ID筛选
initiativeId	`str`	否	按倡议ID筛选
creatorId	`str`	否	按创建者ID筛选
createdAt	`str`	否	筛选创建时间晚于指定值：ISO-8601格式日期/时长（例如：-P1D）
updatedAt	`str`	否	筛选更新时间晚于指定值：ISO-8601格式日期/时长（例如：-P1D）
includeArchived	`bool`	否	是否包含已归档项

示例：

python

result = await app.list_documents(limit=1.0, cursor='example', orderBy='example')

create_document

Create a new document in Linear

Parameter	Type	Required	Description
title	`str`	Yes	Document title
content	`str`	No	Content as Markdown
project	`str`	No	Project name, ID, or slug
issue	`str`	No	Issue ID or identifier (e.g., LIN-123)
icon	`str`	No	Icon emoji
color	`str`	No	Hex color

Example:

python

result = await app.create_document(title="example", content="example", project="example")

在Linear中创建新文档

参数	类型	必填	描述
title	`str`	是	文档标题
content	`str`	否	Markdown格式的文档内容
project	`str`	否	项目名称、ID或别名
issue	`str`	否	问题ID或标识符（例如：LIN-123）
icon	`str`	否	图标emoji
color	`str`	否	十六进制颜色码

示例：

python

result = await app.create_document(title='example', content='example', project='example')

update_document

Update an existing Linear document

Parameter	Type	Required	Description
id	`str`	Yes	Document ID or slug
title	`str`	No	Document title
content	`str`	No	Content as Markdown
project	`str`	No	Project name, ID, or slug
icon	`str`	No	Icon emoji
color	`str`	No	Hex color

Example:

python

result = await app.update_document(id="example", title="example", content="example")

更新Linear中的现有文档

参数	类型	必填	描述
id	`str`	是	文档ID或别名
title	`str`	否	文档标题
content	`str`	否	Markdown格式的文档内容
project	`str`	否	项目名称、ID或别名
icon	`str`	否	图标emoji
color	`str`	否	十六进制颜色码

示例：

python

result = await app.update_document(id='example', title='example', content='example')

extract_images

Extract and fetch images from markdown content. Use this to view screenshots, diagrams, or other images embedded in Linear issues, comments, or documents. Pass the markdown content (e.g., issue description) and receive the images as viewable data.

Parameter	Type	Required	Description
markdown	`str`	Yes	Markdown content containing image references (e.g., issue description, comment body)

Example:

python

result = await app.extract_images(markdown="example")

从Markdown内容中提取并获取图片。可用于查看Linear问题、评论或文档中嵌入的截图、图表等图片。传入Markdown内容（例如问题描述），即可获取可查看的图片数据。

参数	类型	必填	描述
markdown	`str`	是	包含图片引用的Markdown内容（例如：问题描述、评论内容）

示例：

python

result = await app.extract_images(markdown='example')

get_issue

Retrieve detailed information about an issue by ID, including attachments and git branch name

Parameter	Type	Required	Description
id	`str`	Yes	Issue ID
includeRelations	`bool`	No	Include blocking/related/duplicate relations
includeCustomerNeeds	`bool`	No	Include associated customer needs

Example:

python

result = await app.get_issue(id="example", includeRelations=True, includeCustomerNeeds=True)

通过ID获取问题的详细信息，包括附件和Git分支名称

参数	类型	必填	描述
id	`str`	是	问题ID
includeRelations	`bool`	否	是否包含阻塞/关联/重复的关联关系
includeCustomerNeeds	`bool`	否	是否包含关联的客户需求

示例：

python

result = await app.get_issue(id='example', includeRelations=True, includeCustomerNeeds=True)

list_issues

List issues in the user's Linear workspace. For my issues, use "me" as the assignee. Use "null" for no assignee.

Parameter	Type	Required	Description
limit	`float`	No	Max results (default 50, max 250)
cursor	`str`	No	Next page cursor
orderBy	`str`	No	Sort: createdAt
query	`str`	No	Search issue title or description
team	`str`	No	Team name or ID
state	`str`	No	State type, name, or ID
cycle	`str`	No	Cycle name, number, or ID
label	`str`	No	Label name or ID
assignee	`str	None`	No
delegate	`str`	No	Agent name or ID
project	`str`	No	Project name, ID, or slug
priority	`float`	No	0=None, 1=Urgent, 2=High, 3=Normal, 4=Low
parentId	`str`	No	Parent issue ID
createdAt	`str`	No	Created after: ISO-8601 date/duration (e.g., -P1D)
updatedAt	`str`	No	Updated after: ISO-8601 date/duration (e.g., -P1D)
includeArchived	`bool`	No	Include archived items

Example:

python

result = await app.list_issues(limit=1.0, cursor="example", orderBy="example")

列出用户Linear工作区中的所有问题。若要查看自己的问题，将assignee设为"me"；若要查看未分配的问题，设为"null"。

参数	类型	必填	描述
limit	`float`	否	最大结果数（默认50，上限250）
cursor	`str`	否	下一页游标
orderBy	`str`	否	排序方式：createdAt（创建时间）
query	`str`	否	搜索问题标题或描述
team	`str`	否	团队名称或ID
state	`str`	否	状态类型、名称或ID
cycle	`str`	否	迭代周期名称、编号或ID
label	`str`	否	标签名称或ID
assignee	`str	None`	否
delegate	`str`	否	代理名称或ID
project	`str`	否	项目名称、ID或别名
priority	`float`	否	优先级：0=None（无）、1=Urgent（紧急）、2=High（高）、3=Normal（普通）、4=Low（低）
parentId	`str`	否	父问题ID
createdAt	`str`	否	筛选创建时间晚于指定值：ISO-8601格式日期/时长（例如：-P1D）
updatedAt	`str`	否	筛选更新时间晚于指定值：ISO-8601格式日期/时长（例如：-P1D）
includeArchived	`bool`	否	是否包含已归档项

示例：

python

result = await app.list_issues(limit=1.0, cursor='example', orderBy='example')

save_issue

Create or update a Linear issue. If

id

is provided, updates the existing issue; otherwise creates a new one. When creating,

title

and

team

are required.

Parameter	Type	Required	Description
id	`str`	No	Issue ID. If provided, updates the existing issue
title	`str`	No	Issue title (required when creating)
description	`str`	No	Content as Markdown
team	`str`	No	Team name or ID (required when creating)
cycle	`str`	No	Cycle name, number, or ID
milestone	`str`	No	Milestone name or ID
priority	`float`	No	0=None, 1=Urgent, 2=High, 3=Normal, 4=Low
project	`str`	No	Project name, ID, or slug
state	`str`	No	State type, name, or ID
assignee	`str	None`	No
delegate	`str	None`	No
labels	`list[str]`	No	Label names or IDs
dueDate	`str`	No	Due date (ISO format)
parentId	`str	None`	No
estimate	`float`	No	Issue estimate value
links	`list[Any]`	No	Link attachments to add [{url, title}]. Append-only; existing links are never removed
blocks	`list[str]`	No	Issue IDs/identifiers this blocks. Append-only; existing relations are never removed
blockedBy	`list[str]`	No	Issue IDs/identifiers blocking this. Append-only; existing relations are never removed
relatedTo	`list[str]`	No	Related issue IDs/identifiers. Append-only; existing relations are never removed
duplicateOf	`str	None`	No

Example:

python

result = await app.save_issue(id="example", title="example", description="example")

创建或更新Linear问题。若提供

id

则更新现有问题，否则创建新问题。创建时需提供

title

和

team

。

参数	类型	必填	描述
id	`str`	否	问题ID。若提供则更新现有问题
title	`str`	否	问题标题（创建时必填）
description	`str`	否	Markdown格式的描述内容
team	`str`	否	团队名称或ID（创建时必填）
cycle	`str`	否	迭代周期名称、编号或ID
milestone	`str`	否	里程碑名称或ID
priority	`float`	否	优先级：0=None（无）、1=Urgent（紧急）、2=High（高）、3=Normal（普通）、4=Low（低）
project	`str`	否	项目名称、ID或别名
state	`str`	否	状态类型、名称或ID
assignee	`str	None`	否
delegate	`str	None`	否
labels	`list[str]`	否	标签名称或ID列表
dueDate	`str`	否	截止日期（ISO格式）
parentId	`str	None`	否
estimate	`float`	否	问题预估工作量
links	`list[Any]`	否	待添加的链接附件列表 [{url, title}]。仅追加，不会移除现有链接
blocks	`list[str]`	否	被此问题阻塞的问题ID/标识符列表。仅追加，不会移除现有关联
blockedBy	`list[str]`	否	阻塞此问题的问题ID/标识符列表。仅追加，不会移除现有关联
relatedTo	`list[str]`	否	关联问题ID/标识符列表。仅追加，不会移除现有关联
duplicateOf	`str	None`	否

示例：

python

result = await app.save_issue(id='example', title='example', description='example')

list_issue_statuses

List available issue statuses in a Linear team

Parameter	Type	Required	Description
team	`str`	Yes	Team name or ID

Example:

python

result = await app.list_issue_statuses(team="example")

列出Linear团队中可用的问题状态

参数	类型	必填	描述
team	`str`	是	团队名称或ID

示例：

python

result = await app.list_issue_statuses(team='example')

get_issue_status

Retrieve detailed information about an issue status in Linear by name or ID

Parameter	Type	Required	Description
id	`str`	Yes	Status ID
name	`str`	Yes	Status name
team	`str`	Yes	Team name or ID

Example:

python

result = await app.get_issue_status(id="example", name="example", team="example")

通过名称或ID获取Linear中问题状态的详细信息

参数	类型	必填	描述
id	`str`	是	状态ID
name	`str`	是	状态名称
team	`str`	是	团队名称或ID

示例：

python

result = await app.get_issue_status(id='example', name='example', team='example')

list_issue_labels

List available issue labels in a Linear workspace or team

Parameter	Type	Required	Description
limit	`float`	No	Max results (default 50, max 250)
cursor	`str`	No	Next page cursor
orderBy	`str`	No	Sort: createdAt
name	`str`	No	Filter by name
team	`str`	No	Team name or ID

Example:

python

result = await app.list_issue_labels(limit=1.0, cursor="example", orderBy="example")

列出Linear工作区或团队中可用的问题标签

参数	类型	必填	描述
limit	`float`	否	最大结果数（默认50，上限250）
cursor	`str`	否	下一页游标
orderBy	`str`	否	排序方式：createdAt（创建时间）
name	`str`	否	按名称筛选
team	`str`	否	团队名称或ID

示例：

python

result = await app.list_issue_labels(limit=1.0, cursor='example', orderBy='example')

create_issue_label

Create a new Linear issue label

Parameter	Type	Required	Description
name	`str`	Yes	Label name
description	`str`	No	Label description
color	`str`	No	Hex color code
teamId	`str`	No	Team UUID (omit for workspace label)
parent	`str`	No	Parent label group name
isGroup	`bool`	No	Is label group (not directly applicable)

Example:

python

result = await app.create_issue_label(name="example", description="example", color="example")

创建Linear问题标签

参数	类型	必填	描述
name	`str`	是	标签名称
description	`str`	否	标签描述
color	`str`	否	十六进制颜色码
teamId	`str`	否	团队UUID（留空则为工作区标签）
parent	`str`	否	父标签组名称
isGroup	`bool`	否	是否为标签组（暂不直接支持）

示例：

python

result = await app.create_issue_label(name='example', description='example', color='example')

list_projects

List projects in the user's Linear workspace

Parameter	Type	Required	Description
limit	`float`	No	Max results (default 50, max 250)
cursor	`str`	No	Next page cursor
orderBy	`str`	No	Sort: createdAt
query	`str`	No	Search project name
state	`str`	No	State type, name, or ID
initiative	`str`	No	Initiative name or ID
team	`str`	No	Team name or ID
member	`str`	No	User ID, name, email, or "me"
label	`str`	No	Label name or ID
createdAt	`str`	No	Created after: ISO-8601 date/duration (e.g., -P1D)
updatedAt	`str`	No	Updated after: ISO-8601 date/duration (e.g., -P1D)
includeMilestones	`bool`	No	Include milestones
includeMembers	`bool`	No	Include project members
includeArchived	`bool`	No	Include archived items

Example:

python

result = await app.list_projects(limit=1.0, cursor="example", orderBy="example")

列出用户Linear工作区中的所有项目

参数	类型	必填	描述
limit	`float`	否	最大结果数（默认50，上限250）
cursor	`str`	否	下一页游标
orderBy	`str`	否	排序方式：createdAt（创建时间）
query	`str`	否	搜索项目名称
state	`str`	否	状态类型、名称或ID
initiative	`str`	否	倡议名称或ID
team	`str`	否	团队名称或ID
member	`str`	否	用户ID、名称、邮箱或"me"
label	`str`	否	标签名称或ID
createdAt	`str`	否	筛选创建时间晚于指定值：ISO-8601格式日期/时长（例如：-P1D）
updatedAt	`str`	否	筛选更新时间晚于指定值：ISO-8601格式日期/时长（例如：-P1D）
includeMilestones	`bool`	否	是否包含里程碑
includeMembers	`bool`	否	是否包含项目成员
includeArchived	`bool`	否	是否包含已归档项

示例：

python

result = await app.list_projects(limit=1.0, cursor='example', orderBy='example')

get_project

Retrieve details of a specific project in Linear

Parameter	Type	Required	Description
query	`str`	Yes	Project name, ID, or slug
includeMilestones	`bool`	No	Include milestones
includeMembers	`bool`	No	Include project members
includeResources	`bool`	No	Include resources (documents, links, attachments)

Example:

python

result = await app.get_project(query="example", includeMilestones=True, includeMembers=True)

获取Linear中指定项目的详细信息

参数	类型	必填	描述
query	`str`	是	项目名称、ID或别名
includeMilestones	`bool`	否	是否包含里程碑
includeMembers	`bool`	否	是否包含项目成员
includeResources	`bool`	否	是否包含资源（文档、链接、附件）

示例：

python

result = await app.get_project(query='example', includeMilestones=True, includeMembers=True)

save_project

Create or update a Linear project. If

id

is provided, updates the existing project; otherwise creates a new one. When creating,

name

and at least one team (via

addTeams

setTeams

) are required.

Parameter	Type	Required	Description
id	`str`	No	Project ID. If provided, updates the existing project
name	`str`	No	Project name (required when creating)
icon	`str`	No	Icon emoji (e.g., :eagle:)
color	`str`	No	Hex color
summary	`str`	No	Short summary (max 255 chars)
description	`str`	No	Content as Markdown
state	`str`	No	Project state
startDate	`str`	No	Start date (ISO format)
targetDate	`str`	No	Target date (ISO format)
priority	`int`	No	0=None, 1=Urgent, 2=High, 3=Medium, 4=Low
addTeams	`list[str]`	No	Team name or ID to add
removeTeams	`list[str]`	No	Team name or ID to remove
setTeams	`list[str]`	No	Replace all teams with these. Cannot combine with addTeams/removeTeams
labels	`list[str]`	No	Label names or IDs
lead	`str	None`	No
addInitiatives	`list[str]`	No	Initiative names/IDs to add
removeInitiatives	`list[str]`	No	Initiative names/IDs to remove
setInitiatives	`list[str]`	No	Replace all initiatives with these. Cannot combine with addInitiatives/removeInitiatives

Example:

python

result = await app.save_project(id="example", name="example", icon="example")

创建或更新Linear项目。若提供

id

则更新现有项目，否则创建新项目。创建时需提供

name

，并至少指定一个团队（通过

addTeams

或

setTeams

）。

参数	类型	必填	描述
id	`str`	否	项目ID。若提供则更新现有项目
name	`str`	否	项目名称（创建时必填）
icon	`str`	否	图标emoji（例如：:eagle:）
color	`str`	否	十六进制颜色码
summary	`str`	否	简短概述（最多255字符）
description	`str`	否	Markdown格式的描述内容
state	`str`	否	项目状态
startDate	`str`	否	开始日期（ISO格式）
targetDate	`str`	否	目标日期（ISO格式）
priority	`int`	否	优先级：0=None（无）、1=Urgent（紧急）、2=High（高）、3=Medium（中）、4=Low（低）
addTeams	`list[str]`	否	待添加的团队名称或ID列表
removeTeams	`list[str]`	否	待移除的团队名称或ID列表
setTeams	`list[str]`	否	替换为指定团队列表。不可与addTeams/removeTeams同时使用
labels	`list[str]`	否	标签名称或ID列表
lead	`str	None`	否
addInitiatives	`list[str]`	否	待添加的倡议名称/ID列表
removeInitiatives	`list[str]`	否	待移除的倡议名称/ID列表
setInitiatives	`list[str]`	否	替换为指定倡议列表。不可与addInitiatives/removeInitiatives同时使用

示例：

python

result = await app.save_project(id='example', name='example', icon='example')

list_project_labels

List available project labels in the Linear workspace

Parameter	Type	Required	Description
limit	`float`	No	Max results (default 50, max 250)
cursor	`str`	No	Next page cursor
orderBy	`str`	No	Sort: createdAt

...additional tools omitted for brevity

列出Linear工作区中可用的项目标签

参数	类型	必填	描述
limit	`float`	否	最大结果数（默认50，上限250）
cursor	`str`	否	下一页游标
orderBy	`str`	否	排序方式：createdAt（创建时间）

...为简洁起见，省略其余工具