Important API details:
- Authentication uses OAuth 2.1 with dynamic client registration — Caylex handles the OAuth flow on your behalf.
- The server is centrally hosted and managed by Linear, meaning tool availability and behavior may be updated by Linear independently.
- More functionality is actively being added to the server; some advanced Linear features may not yet be exposed as tools.
- For Jules-style API key authentication, a personal API key can be generated under Linear Settings > Account > Security & Access.
Server Details
| Property | Value |
|---|---|
| Transport | Streamable HTTP |
| Hosting | Remote (externally hosted) |
| Categories | Project Management, Business Operations |
Authentication
This server supports the following authentication method:OAuth
Scopes:read, write, issues:create, comments:create, timeSchedule:write
During the server onboarding flow, you will be prompted to complete the OAuth flow to grant access. See the Linear Authentication guide for step-by-step credential configuration.
Getting Started
Add the server
Navigate to the Server Library and click on the New Server button. Find Linear in the Caylex Catalog.
Use in a project
Add the server to a project by configuring project connections. Its tools are now available to any agents connected to that project.
Available Tools
This server provides 38 tools:Issues
get_issue
get_issue
Retrieve detailed information about an issue by ID, including attachments and git branch name
save_issue
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.list_issues
list_issues
List issues in the user’s Linear workspace. For my issues, use “me” as the assignee. Use “null” for no assignee.
list_issue_statuses
list_issue_statuses
List available issue statuses in a Linear team
get_issue_status
get_issue_status
Retrieve detailed information about an issue status in Linear by name or ID
list_issue_labels
list_issue_labels
List available issue labels in a Linear workspace or team
create_issue_label
create_issue_label
Create a new Linear issue label
Comments
list_comments
list_comments
List comments for a specific Linear issue
save_comment
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.delete_comment
delete_comment
Delete a comment from a Linear issue
Projects
get_project
get_project
Retrieve details of a specific project in Linear
list_projects
list_projects
List projects in the user’s Linear workspace
save_project
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 or setTeams) are required.list_project_labels
list_project_labels
List available project labels in the Linear workspace
Documents
list_documents
list_documents
List documents in the user’s Linear workspace
get_document
get_document
Retrieve a Linear document by ID or slug
create_document
create_document
Create a new document in Linear
update_document
update_document
Update an existing Linear document
search_documentation
search_documentation
Search Linear’s documentation to learn about features and usage
Milestones
get_milestone
get_milestone
Retrieve details of a specific milestone by ID or name
list_milestones
list_milestones
List all milestones in a Linear project
save_milestone
save_milestone
Create or update a milestone in a Linear project. If
id is provided, updates the existing milestone; otherwise creates a new one. When creating, name is required.Initiatives
list_initiatives
list_initiatives
List initiatives in the user’s Linear workspace
get_initiative
get_initiative
Retrieve detailed information about a specific initiative in Linear
save_initiative
save_initiative
Create or update a Linear initiative. If
id is provided, updates the existing initiative; otherwise creates a new one. When creating, name is required.Cycles
list_cycles
list_cycles
Retrieve cycles for a specific Linear team
Status Updates
get_status_updates
get_status_updates
List or get project/initiative status updates. Pass
id to get a specific update, or filter to list.save_status_update
save_status_update
Create or update a project/initiative status update. Omit
id to create, provide id to update.delete_status_update
delete_status_update
Delete (archive) a project or initiative status update.
Attachments
create_attachment
create_attachment
Create a new attachment on a specific Linear issue by uploading base64-encoded content.
get_attachment
get_attachment
Retrieve an attachment’s content by ID.
delete_attachment
delete_attachment
Delete an attachment by ID
extract_images
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.
Teams
get_team
get_team
Retrieve details of a specific Linear team
list_teams
list_teams
List teams in the user’s Linear workspace
Users
get_user
get_user
Retrieve details of a specific Linear user
list_users
list_users
Retrieve users in the Linear workspace
get_authenticated_user
get_authenticated_user
Retrieve the profile of the currently authenticated user
Related Servers
Github
Slack
