Linear

Connect Linear to find, report on, and update product work from Assistant.

What it can do

• Search and read issues, projects, cycles, milestones, initiatives, documents, and customer requests.
• Summarize project and initiative status from issues and status updates.
• Create or update issues, comments, documents, projects, milestones, and status updates.
• Review code review diffs and their threads, and comment, resolve, review, or merge.

Setup and security

• You sign in with your own Linear account. Assistant can reach only the workspaces, teams, and issues that account can.
• Tools that change data ask for approval before they run. The Approval column under Supported tools shows each tool's setting.
• Linear also advertises an internal mcp_auth tool. Nomic blocks it, so Assistant cannot call it.

To connect, see Add an MCP server.

Example requests

• "Summarize open issues in the current cycle for the Platform team, grouped by assignee."
• "Draft a project status update for Q4 Onboarding from issues closed this week."
• "Create an issue for the drawing viewer bug described above and assign it to me."
• "List initiatives planned for next quarter with the latest status update for each."

Supported tools

Issues, comments, and attachments

Tool	Action	Approval
get_issue	Read one issue.	Not required
list_issues	Search and list issues.	Not required
save_issue	Create or update an issue.	Required
list_issue_statuses	List available issue statuses.	Not required
get_issue_status	Read one issue status.	Not required
list_issue_labels	List issue labels.	Not required
create_issue_label	Create an issue label.	Required
list_comments	List comments on an issue or document.	Not required
save_comment	Create or update a comment.	Required
delete_comment	Delete a comment.	Required
get_attachment	Read attachment metadata or content.	Not required
prepare_attachment_upload	Prepare a direct file upload to Linear.	Required
create_attachment_from_upload	Attach a completed upload to an issue.	Required
create_attachment	Upload and attach a small file.	Required
delete_attachment	Delete an attachment.	Required
extract_images	Fetch images embedded in Linear Markdown content.	Required

Projects, cycles, and milestones

Tool	Action	Approval
list_projects	List or search projects.	Not required
get_project	Read one project.	Not required
save_project	Create or update a project.	Required
list_project_labels	List project labels.	Not required
list_cycles	List team cycles.	Not required
list_milestones	List project milestones.	Not required
get_milestone	Read one milestone.	Not required
save_milestone	Create or update a milestone.	Required

Documents and workspace

Tool	Action	Approval
list_documents	List or search Linear documents.	Not required
get_document	Read one document.	Not required
save_document	Create or update a document.	Required
search_documentation	Search Linear's product documentation.	Not required
list_teams	List workspace teams.	Not required
get_team	Read one team.	Not required
list_users	List workspace members.	Not required
get_user	Read one member's profile.	Not required
get_workspace	Read workspace details.	Not required
list_agent_skills	List agent skills published in the workspace.	Not required
get_agent_skill	Read one agent skill.	Not required

Releases and code review

Tool	Action	Approval
list_release_pipelines	List release pipelines.	Not required
list_releases	List releases.	Not required
get_release	Read one release.	Not required
save_release	Create or update a release.	Required
list_release_notes	List release notes.	Not required
get_release_note	Read one release note.	Not required
save_release_note	Create or update release notes.	Required
list_diffs	List code review diffs.	Not required
get_diff	Read one diff.	Not required
get_diff_threads	Read discussion threads on a diff.	Not required
save_diff_comment	Add or update a diff comment.	Required
resolve_diff_thread	Resolve or reopen a diff discussion.	Required
delete_diff_comment	Delete a diff comment.	Required
submit_diff_review	Submit a code review.	Required
merge_diff	Merge an approved diff.	Required

Customers, initiatives, and updates

Tool	Action	Approval
list_customers	List or search customers.	Not required
save_customer	Create or update a customer.	Required
delete_customer	Delete a customer.	Required
save_customer_need	Create or update a customer need.	Required
delete_customer_need	Delete a customer need.	Required
list_initiatives	List or search initiatives.	Not required
get_initiative	Read one initiative.	Not required
save_initiative	Create or update an initiative.	Required
list_initiative_labels	List initiative labels.	Not required
create_initiative_label	Create an initiative label.	Required
get_status_updates	Read project or initiative status updates.	Not required
save_status_update	Create or update a status update.	Required
delete_status_update	Delete a status update.	Required