Linear Connector
3 minute read
Overview
The Linear connector enables AI Team members to interact with your Linear workspace, providing capabilities for issue management, project tracking, and workflow coordination. By connecting Linear to AI Team, AI teammates can query issue status, manage projects, track cycles, and help coordinate engineering work.
The connector provides access to issues, comments, projects, cycles, teams, and workflow states, allowing AI teammates to help with issue tracking, sprint planning, and project management tasks.
Add the Linear Connector
To add the Linear connector, you authorize Edge Delta to access your Linear workspace using OAuth.
Prerequisites
Before configuring the connector, ensure you have:
- Linear workspace with appropriate permissions
- Ability to authorize OAuth applications
Configuration Steps
- Navigate to AI Team > Connectors in the Edge Delta application
- Find the Linear connector
- Click the connector card
- Click Approve in Linear to authorize the connection
The connector is now available for use by AI Team members who have been assigned this connector.
Tools
list_comments
List comments for a specific Linear issue.
create_comment
Create a comment on a specific Linear issue.
list_cycles
Retrieve cycles for a specific Linear team.
get_document
Retrieve a Linear document by ID or slug.
list_documents
List documents in the Linear workspace.
get_issue
Retrieve detailed information about an issue by ID, including attachments and git branch name.
list_issues
List issues in the Linear workspace. For issues assigned to the current user, use “me” as the assignee.
create_issue
Create a new Linear issue.
update_issue
Update an existing Linear issue.
list_issue_statuses
List available issue statuses in a Linear team.
get_issue_status
Retrieve detailed information about an issue status in Linear by name or ID.
list_issue_labels
List available issue labels in a Linear workspace or team.
create_issue_label
Create a new Linear issue label.
list_projects
List projects in the Linear workspace.
get_project
Retrieve details of a specific project in Linear.
create_project
Create a new project in Linear.
update_project
Update an existing Linear project.
list_project_labels
List available project labels in the Linear workspace.
list_teams
List teams in the Linear workspace.
get_team
Retrieve details of a specific Linear team.
list_users
Retrieve users in the Linear workspace.
get_user
Retrieve details of a specific Linear user.
search_documentation
Search Linear’s documentation to learn about features and usage.
How to Use the Linear Connector
The Linear connector integrates with AI Team, enabling AI teammates to manage Linear issues and projects based on natural language queries. Once configured, AI teammates can help with issue tracking, project coordination, and workflow management.
Use Case: Issue Management
AI teammates can help create, update, and track Linear issues. For example, when investigating incidents or planning work, the AI can create issues with appropriate details, update issue status, add comments with findings, and track issue progress.
Use Case: Project Tracking
AI teammates can monitor project status and progress. When asked about project status, the AI can retrieve project details, list associated issues, check completion status, and provide progress summaries.
Use Case: Sprint Planning
AI teammates can help with sprint planning by querying cycle information, listing issues in the current cycle, checking team capacity, and coordinating work assignments across the team.
Troubleshooting
Authorization errors: Try disconnecting and reconnecting the OAuth authorization. Ensure you have the necessary permissions in your Linear workspace.
Permission errors: Verify your Linear user has appropriate permissions for the operations AI teammates need to perform (creating issues, updating projects, etc.).
Missing data: Check that you have access to the teams and projects where the data exists. Some data may be restricted based on workspace permissions.
Next Steps
- Learn about creating custom teammates that can use this connector
- Explore other connectors to integrate additional tools
For additional help, visit AI Team Support.