Summary
A streamable HTTP gateway that wraps Linear's GraphQL API with OAuth authentication, letting Claude interact with your Linear workspace through Pipeworx's infrastructure. The server is part of a larger gateway offering 673+ data sources, so you can either use it standalone or tap into the full Pipeworx suite. Instead of calling specific tools, you can use ask_pipeworx to query Linear data in plain English and let the gateway handle tool selection and argument mapping. Useful if you want Claude to read issues, update tasks, or pull project data without managing OAuth flows yourself. The exact tool list isn't documented in the repo, but it's a GraphQL wrapper so expect standard Linear operations like querying issues, teams, and projects.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
25 tools
list_commentsList comments for a specific Linear issue1 params
List comments for a specific Linear issue
Parameters* required
issueIdstringThe issue ID
create_commentCreate a comment on a specific Linear issue3 params
Create a comment on a specific Linear issue
Parameters* required
bodystringThe content of the comment as Markdown
issueIdstringThe issue ID
parentIdstringA parent comment ID to reply to
list_cyclesRetrieve cycles for a specific Linear team2 params
Retrieve cycles for a specific Linear team
Parameters* required
typestringRetrieve the current, previous, next, or all cycles. If no type is provided all cycles in the team will be returnedone of
current · previous · nextteamIdstringThe team ID
get_documentRetrieve a Linear document by ID or slug1 params
Retrieve a Linear document by ID or slug
Parameters* required
idstringThe document ID or slug
list_documentsList documents in the user's Linear workspace11 params
List documents in the user's Linear workspace
Parameters* required
afterstringAn ID to start from
limitnumberThe number of results to return (Max is 250)default: 50
querystringAn optional search query
beforestringAn ID to end at
orderBystringThe order in which to return resultsone of
createdAt · updatedAtdefault: updatedAtcreatedAtstringReturn only documents created on or after this ISO-8601 date-time or duration. e.g. -P1D to get documents created in the last day
creatorIdstringFilter by creator ID
projectIdstringFilter by project ID
updatedAtstringReturn only documents updated on or after this ISO-8601 date-time or duration. e.g. -P1D to get documents updated in the last day
initiativeIdstringFilter by initiative ID
includeArchivedbooleanWhether to include archived documentsdefault: false
create_documentCreate a new document in Linear5 params
Create a new document in Linear
Parameters* required
iconstringThe icon of the document (for example, ":page_facing_up:")
colorstringThe color of the icon (hex color code)
titlestringThe title of the document
contentstringThe document content as Markdown
projectstringThe project name or ID to associate the document with
update_documentUpdate an existing Linear document6 params
Update an existing Linear document
Parameters* required
idstringThe document ID to update
iconstringThe icon of the document (for example, ":page_facing_up:")
colorstringThe color of the icon (hex color code)
titlestringThe new title of the document
contentstringThe new document content as Markdown
projectstringThe project name or ID to associate the document with
get_issueRetrieve detailed information about an issue by ID, including attachments and git branch name2 params
Retrieve detailed information about an issue by ID, including attachments and git branch name
Parameters* required
idstringThe issue ID
includeRelationsbooleanWhether to include blocking, related, and duplicate relations in the responsedefault: false
list_issuesList issues in the user's Linear workspace. For my issues, use "me" as the assignee.16 params
List issues in the user's Linear workspace. For my issues, use "me" as the assignee.
Parameters* required
teamstringThe team name or ID to filter by
afterstringAn ID to start from
cyclestringThe cycle name or ID to filter by
labelstringA label name or ID to filter by
limitnumberThe number of results to return (Max is 250)default: 50
querystringSearch for content in the issue title or description
statestringThe state name or ID to filter by
beforestringAn ID to end at
orderBystringThe order in which to return resultsone of
createdAt · updatedAtdefault: updatedAtprojectstringThe project name or ID to filter by
assigneestringThe assignee to filter by (User ID, name, email, or "me")
delegatestringAn agent name or ID to filter by
parentIdstringThe parent issue ID to filter by
createdAtstringReturn only issues created on or after this ISO-8601 date-time or duration. e.g. -P1D to get issues created in the last day
updatedAtstringReturn only issues updated on or after this ISO-8601 date-time or duration. e.g. -P1D to get issues updated in the last day
includeArchivedbooleanWhether to include archived issues. Defaults to true.default: true
create_issueCreate a new Linear issue18 params
Create a new Linear issue
Parameters* required
teamstringThe team name or ID
cyclestringThe cycle name, number, or ID to add the issue to
linksarrayArray of link objects to attach to the issue. Each object must contain a valid `url` and a non-empty `title`.
statestringThe issue state type, name, or ID
titlestringThe issue title
blocksarrayArray of issue IDs or identifiers (e.g., 'LIN-123') that this issue blocks. Creates blocking relations on issue creation.
labelsarrayArray of label names or IDs to set on the issue (you can use label names directly, no need to look up IDs)
dueDatestringThe due date for the issue in ISO format
projectstringThe project name or ID to add the issue to
assigneestringThe user to assign (User ID, name, email, or "me")
delegatestringThe agent name, displayName, or ID to delegate
parentIdstringThe parent issue ID, if this is a sub-issue
prioritynumberThe issue priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low. Do not set this field unless explicitly requested.
blockedByarrayArray of issue IDs or identifiers (e.g., 'LIN-123') that block this issue. Creates blocking relations on issue creation.
milestonestringThe milestone name or ID to add the issue to
relatedToarrayArray of issue IDs or identifiers (e.g., 'LIN-123') that are related to this issue. Creates related relations on issue creation.
descriptionstringThe issue description as Markdown
duplicateOfstringIssue ID or identifier (e.g., 'LIN-123') that this issue is a duplicate of. Creates a duplicate relation on issue creation.
update_issueUpdate an existing Linear issue19 params
Update an existing Linear issue
Parameters* required
idstringThe issue ID
cyclestringThe cycle name, number, or ID
linksarrayArray of link objects to attach to the issue. Each object must contain a valid `url` and a non-empty `title`.
statestringThe issue state type, name, or ID
titlestringThe issue title
blocksarrayArray of issue IDs or identifiers (e.g., 'LIN-123') that this issue blocks. WARNING: This REPLACES all existing blocking relations. You must include ALL issues you want blocked, not just new ones. Omit this field entirely to leave existing relations unchanged. Pass an empty array to remove all blocking relations.
labelsarrayArray of label names or IDs to set on the issue (you can use label names directly, no need to look up IDs)
dueDatestringThe due date for the issue in ISO format
projectstringThe project name or ID to add the issue to
assigneestringThe user to assign (User ID, name, email, or "me")
delegatestringThe agent name, displayName, or ID to delegate
estimatenumberThe numerical issue estimate value
parentIdstringThe parent issue ID, if this is a sub-issue
prioritynumberThe issue priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low. Do not set this field unless explicitly requested.
blockedByarrayArray of issue IDs or identifiers (e.g., 'LIN-123') that block this issue. WARNING: This REPLACES all existing blocked-by relations. You must include ALL blocking issues, not just new ones. Omit this field entirely to leave existing relations unchanged. Pass an empty array to remove all blocked-by relations.
milestonestringThe milestone name or ID
relatedToarrayArray of issue IDs or identifiers (e.g., 'LIN-123') related to this issue. WARNING: This REPLACES all existing related relations. You must include ALL related issues, not just new ones. Omit this field entirely to leave existing relations unchanged. Pass an empty array to remove all related relations.
descriptionstringThe issue description as Markdown
duplicateOfstringIssue ID or identifier (e.g., 'LIN-123') this is a duplicate of. Replaces existing duplicate relation. Omit to leave unchanged, pass null to remove.
list_issue_statusesList available issue statuses in a Linear team1 params
List available issue statuses in a Linear team
Parameters* required
teamstringThe team name or ID
get_issue_statusRetrieve detailed information about an issue status in Linear by name or ID3 params
Retrieve detailed information about an issue status in Linear by name or ID
Parameters* required
idstringThe ID of the issue status to retrieve
namestringThe name of the issue status to retrieve
teamstringThe team name or ID
list_issue_labelsList available issue labels in a Linear workspace or team6 params
List available issue labels in a Linear workspace or team
Parameters* required
namestringFilter by label name
teamstringThe team name or ID
afterstringAn ID to start from
limitnumberThe number of results to return (Max is 250)default: 50
beforestringAn ID to end at
orderBystringThe order in which to return resultsone of
createdAt · updatedAtdefault: updatedAtcreate_issue_labelCreate a new Linear issue label6 params
Create a new Linear issue label
Parameters* required
namestringThe name of the label
colorstringThe color of the label (hex color code)
teamIdstringThe team UUID. If not provided, the label will be created as a workspace label
isGroupbooleanWhether this is label group (cannot be applied to issues directly)default: false
parentIdstringThe parent label UUID, if this is a child of a label group
descriptionstringAn optional description of the label
list_projectsList projects in the user's Linear workspace12 params
List projects in the user's Linear workspace
Parameters* required
teamstringThe team name or ID to filter by
afterstringAn ID to start from
limitnumberThe number of results to return (Max is 250)default: 50
querystringSearch for content in the project name
statestringThe state name or ID to filter by
beforestringAn ID to end at
memberstringA team member to filter by (User ID, name, email, or "me")
orderBystringThe order in which to return resultsone of
createdAt · updatedAtdefault: updatedAtcreatedAtstringReturn only projects created on or after this ISO-8601 date-time or duration. e.g. -P1D to get projects created in the last day
updatedAtstringReturn only projects updated on or after this ISO-8601 date-time or duration. e.g. -P1D to get projects updated in the last day
initiativestringThe initiative name or ID to filter by
includeArchivedbooleanWhether to include archived projectsdefault: false
get_projectRetrieve details of a specific project in Linear1 params
Retrieve details of a specific project in Linear
Parameters* required
querystringThe ID or name of the project to retrieve
create_projectCreate a new project in Linear13 params
Create a new project in Linear
Parameters* required
iconstringThe icon of the project (for example, ":eagle:")
leadstringThe user to assign (User ID, name, email, or "me")
namestringA descriptive name of the project
teamstringThe team name or ID
colorstringA hex color for the project
statestringThe state of the project
labelsarrayArray of labels or IDs to set on the project
summarystringA concise plaintext summary of the project (max 255 chars)
priorityintegerThe priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low
startDatestringThe start date of the project in ISO format
initiativestringAn initiative ID or name to associate with the project
targetDatestringThe target date of the project in ISO format
descriptionstringThe full project description in Markdown format
update_projectUpdate an existing Linear project13 params
Update an existing Linear project
Parameters* required
idstringThe ID of the project to update
iconstringThe new icon of the project (for example, ":eagle:")
leadstringThe user to assign (User ID, name, email, or "me")
namestringThe new name of the project
colorstringThe new hex color for the project
statestringThe state of the project
labelsarrayArray of labels or IDs to set on the project
summarystringA concise plaintext summary of the project (max 255 chars)
priorityintegerThe priority of the project. 0 = No priority, 1 = Urgent, 2 = High, 3 = Medium, 4 = Low
startDatestringThe start date of the project in ISO format
targetDatestringThe target date of the project in ISO format
descriptionstringThe full project description in Markdown format
initiativesarrayArray of initiative IDs or names to associate with the project
list_project_labelsList available project labels in the Linear workspace5 params
List available project labels in the Linear workspace
Parameters* required
namestringFilter by label name
afterstringAn ID to start from
limitnumberThe number of results to return (Max is 250)default: 50
beforestringAn ID to end at
orderBystringThe order in which to return resultsone of
createdAt · updatedAtdefault: updatedAtlist_teamsList teams in the user's Linear workspace8 params
List teams in the user's Linear workspace
Parameters* required
afterstringAn ID to start from
limitnumberThe number of results to return (Max is 250)default: 50
querystringAn optional search query
beforestringAn ID to end at
orderBystringThe order in which to return resultsone of
createdAt · updatedAtdefault: updatedAtcreatedAtstringReturn only teams created on or after this ISO-8601 date-time or duration. e.g. -P1D to get teams created in the last day
updatedAtstringReturn only teams updated on or after this ISO-8601 date-time or duration. e.g. -P1D to get teams updated in the last day
includeArchivedbooleanWhether to include archived teamsdefault: false
get_teamRetrieve details of a specific Linear team1 params
Retrieve details of a specific Linear team
Parameters* required
querystringThe UUID, key, or name of the team to retrieve
list_usersRetrieve users in the Linear workspace2 params
Retrieve users in the Linear workspace
Parameters* required
teamstringOptional team name or ID to filter members from
querystringOptional query to filter users by name or email
get_userRetrieve details of a specific Linear user1 params
Retrieve details of a specific Linear user
Parameters* required
querystringThe user to retrieve (User ID, name, email, or "me")
search_documentationSearch Linear's documentation to learn about features and usage2 params
Search Linear's documentation to learn about features and usage
Parameters* required
pagenumberThe page numberdefault: 0
querystringThe search query
mcp-linear
Linear MCP — wraps the Linear GraphQL API (OAuth)
Part of Pipeworx — an MCP gateway connecting AI agents to 673+ live data sources.
Tools
| Tool | Description |
|---|
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"linear": {
"url": "https://gateway.pipeworx.io/linear/mcp"
}
}
}
Or connect to the full Pipeworx gateway for access to all 673+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Linear data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
