Skip to main content

​
Linear

Shanone’s Linear integration gives your agent 45 tools for issue tracking, project and cycle management, initiatives, and documents.

​
Getting Started

1

Connect via OAuth

Ask your agent to do something with Linear (e.g. “create an issue for this bug”), or connect proactively from Integrations in the Shanone dashboard.
2

Authorize workspace access

Approve Linear’s OAuth consent screen for the workspace you want Shanone to act on.
3

Retry your request

Once connected, shanone_execute_tool calls for linear_* tools will succeed.

​
Available Tools

Shanone provides 45 tools for Linear, organized into these categories:
linear_create_issue, linear_get_issue, linear_update_issue, linear_delete_issue, linear_archive_issue, linear_unarchive_issue, linear_list_issues, linear_search_issues, linear_get_my_issues, linear_add_label_to_issue, linear_add_issue_to_cycle, linear_add_issue_to_project
linear_create_comment, linear_list_comments, linear_delete_comment
linear_create_project, linear_get_project, linear_update_project, linear_list_projects, linear_create_project_update, linear_list_project_updates, linear_list_project_labels
linear_create_initiative, linear_get_initiative, linear_update_initiative, linear_list_initiatives, linear_create_initiative_update
linear_list_cycles, linear_create_milestone, linear_get_milestone, linear_update_milestone, linear_list_milestones
linear_create_document, linear_get_document, linear_update_document, linear_list_documents, linear_search_documentation
linear_get_team, linear_list_teams, linear_get_user, linear_list_users, linear_get_viewer, linear_create_label, linear_list_labels, linear_list_workflow_states

​
Common Use Cases

Bug triage

Create issues directly from stack traces or bug reports surfaced elsewhere

Sprint reporting

Summarize a cycle’s issues and post a status update

Cross-tool follow-ups

Turn Notion meeting notes or Slack threads into tracked Linear issues

Roadmap visibility

Query initiatives and projects to answer “what’s planned for Q3?”

​
Troubleshooting

Linear issues require a valid teamId and, in some workflows, a valid state ID. Call linear_list_teams and linear_list_workflow_states first to get valid values, or check shanone_get_tool_schema for linear_create_issue.
Use linear_search_issues with the identifier as the query, or linear_list_issues filtered by team — linear_get_issue expects Linear’s internal issue ID, not the short identifier, unless the tool schema indicates otherwise.