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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →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
teamIdstringThe team ID
typestringRetrieve the current, previous, next, or all cycles. If no type is provided all cycles in the team will be returnedone of
current · previous · nextget_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
beforestringAn ID to end at
createdAtstringReturn 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
includeArchivedbooleanWhether to include archived documentsdefault: false
initiativeIdstringFilter by initiative ID
limitnumberThe number of results to return (Max is 250)default: 50
orderBystringThe order in which to return resultsone of
createdAt · updatedAtdefault: updatedAtprojectIdstringFilter by project ID
querystringAn optional search query
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
create_documentCreate a new document in Linear5 params
Create a new document in Linear
Parameters* required
colorstringThe color of the icon (hex color code)
contentstringThe document content as Markdown
iconstringThe icon of the document (for example, ":page_facing_up:")
projectstringThe project name or ID to associate the document with
titlestringThe title of the document
update_documentUpdate an existing Linear document6 params
Update an existing Linear document
Parameters* required
colorstringThe color of the icon (hex color code)
contentstringThe new document content as Markdown
iconstringThe icon of the document (for example, ":page_facing_up:")
idstringThe document ID to update
projectstringThe project name or ID to associate the document with
titlestringThe new title of the document
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
afterstringAn ID to start from
assigneestringThe assignee to filter by (User ID, name, email, or "me")
beforestringAn ID to end at
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
cyclestringThe cycle name or ID to filter by
delegatestringAn agent name or ID to filter by
includeArchivedbooleanWhether to include archived issues. Defaults to true.default: true
labelstringA label name or ID to filter by
limitnumberThe number of results to return (Max is 250)default: 50
orderBystringThe order in which to return resultsone of
createdAt · updatedAtdefault: updatedAtparentIdstringThe parent issue ID to filter by
projectstringThe project name or ID to filter by
querystringSearch for content in the issue title or description
statestringThe state name or ID to filter by
teamstringThe team name or ID to filter by
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
create_issueCreate a new Linear issue18 params
Create a new Linear issue
Parameters* required
assigneestringThe user to assign (User ID, name, email, or "me")
blockedByarrayArray of issue IDs or identifiers (e.g., 'LIN-123') that block this issue. Creates blocking relations on issue creation.
blocksarrayArray of issue IDs or identifiers (e.g., 'LIN-123') that this issue blocks. Creates blocking relations on issue creation.
cyclestringThe cycle name, number, or ID to add the issue to
delegatestringThe agent name, displayName, or ID to delegate
descriptionstringThe issue description as Markdown
dueDatestringThe due date for the issue in ISO format
duplicateOfstringIssue ID or identifier (e.g., 'LIN-123') that this issue is a duplicate of. Creates a duplicate relation 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)
linksarrayArray of link objects to attach to the issue. Each object must contain a valid `url` and a non-empty `title`.
milestonestringThe milestone name or ID to add the issue to
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.
projectstringThe project 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.
statestringThe issue state type, name, or ID
teamstringThe team name or ID
titlestringThe issue title
update_issueUpdate an existing Linear issue19 params
Update an existing Linear issue
Parameters* required
assigneestringThe user to assign (User ID, name, email, or "me")
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 th...
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....
cyclestringThe cycle name, number, or ID
delegatestringThe agent name, displayName, or ID to delegate
descriptionstringThe issue description as Markdown
dueDatestringThe due date for the issue in ISO format
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.
estimatenumberThe numerical issue estimate value
idstringThe issue ID
labelsarrayArray of label names or IDs to set on the issue (you can use label names directly, no need to look up IDs)
linksarrayArray of link objects to attach to the issue. Each object must contain a valid `url` and a non-empty `title`.
milestonestringThe milestone name or ID
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.
projectstringThe project name or ID to add the issue to
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 f...
statestringThe issue state type, name, or ID
titlestringThe issue title
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
afterstringAn ID to start from
beforestringAn ID to end at
limitnumberThe number of results to return (Max is 250)default: 50
namestringFilter by label name
orderBystringThe order in which to return resultsone of
createdAt · updatedAtdefault: updatedAtteamstringThe team name or ID
create_issue_labelCreate a new Linear issue label6 params
Create a new Linear issue label
Parameters* required
colorstringThe color of the label (hex color code)
descriptionstringAn optional description of the label
isGroupbooleanWhether this is label group (cannot be applied to issues directly)default: false
namestringThe name of the label
parentIdstringThe parent label UUID, if this is a child of a label group
teamIdstringThe team UUID. If not provided, the label will be created as a workspace label
list_projectsList projects in the user's Linear workspace12 params
List projects in the user's Linear workspace
Parameters* required
afterstringAn ID to start from
beforestringAn ID to end at
createdAtstringReturn only projects created on or after this ISO-8601 date-time or duration. e.g. -P1D to get projects created in the last day
includeArchivedbooleanWhether to include archived projectsdefault: false
initiativestringThe initiative name or ID to filter by
limitnumberThe number of results to return (Max is 250)default: 50
memberstringA team member to filter by (User ID, name, email, or "me")
orderBystringThe order in which to return resultsone of
createdAt · updatedAtdefault: updatedAtquerystringSearch for content in the project name
statestringThe state name or ID to filter by
teamstringThe team name or ID to filter by
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
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
colorstringA hex color for the project
descriptionstringThe full project description in Markdown format
iconstringThe icon of the project (for example, ":eagle:")
initiativestringAn initiative ID or name to associate with the project
labelsarrayArray of labels or IDs to set on the project
leadstringThe user to assign (User ID, name, email, or "me")
namestringA descriptive name of the project
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
statestringThe state of the project
summarystringA concise plaintext summary of the project (max 255 chars)
targetDatestringThe target date of the project in ISO format
teamstringThe team name or ID
update_projectUpdate an existing Linear project13 params
Update an existing Linear project
Parameters* required
colorstringThe new hex color for the project
descriptionstringThe full project description in Markdown format
iconstringThe new icon of the project (for example, ":eagle:")
idstringThe ID of the project to update
initiativesarrayArray of initiative IDs or names to associate with the project
labelsarrayArray of labels or IDs to set on the project
leadstringThe user to assign (User ID, name, email, or "me")
namestringThe new name of the project
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
statestringThe state of the project
summarystringA concise plaintext summary of the project (max 255 chars)
targetDatestringThe target date of the project in ISO format
list_project_labelsList available project labels in the Linear workspace5 params
List available project labels in the Linear workspace
Parameters* required
afterstringAn ID to start from
beforestringAn ID to end at
limitnumberThe number of results to return (Max is 250)default: 50
namestringFilter by label name
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
beforestringAn ID to end at
createdAtstringReturn only teams created on or after this ISO-8601 date-time or duration. e.g. -P1D to get teams created in the last day
includeArchivedbooleanWhether to include archived teamsdefault: false
limitnumberThe number of results to return (Max is 250)default: 50
orderBystringThe order in which to return resultsone of
createdAt · updatedAtdefault: updatedAtquerystringAn optional search query
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
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
querystringOptional query to filter users by name or email
teamstringOptional team name or ID to filter members from
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 1476+ live data sources.
Tools
| Tool | Description |
|---|---|
linear_list_issues | Browse issues in your Linear workspace with optional filters by state, priority, or assignee. Returns issue ID, title, state, priority, assignee, and URL. |
linear_get_issue | Get full details of a Linear issue by ID (e.g., "ABC-123"). Returns title, description, state, priority, assignee, labels, comments, and URL. |
linear_create_issue | Create a new issue in Linear with title and optional description. Returns issue ID, key, title, and URL. |
linear_list_teams | List all teams in your Linear workspace. Returns team ID, name, key, and description. |
linear_search | Search Linear issues by keyword or text. Returns matching issues with ID, title, state, priority, and URL. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"linear": {
"url": "https://gateway.pipeworx.io/linear/mcp"
}
}
}
What this endpoint actually serves
tools/list at https://gateway.pipeworx.io/linear/mcp returns the tools in the table
above plus the shared Pipeworx meta-tools — ask_pipeworx,
discover_tools, search_within, remember/recall and the rest of the
gateway-wide set. So the tool count you see is larger than this table: a
single-pack endpoint currently lists roughly 30 shared tools alongside the
pack's own. The connection's initialize response states its exact scope, and
is the authoritative answer for a given day.
This is deliberate, not multiplexing by accident. The meta-tools are what let a
scoped connection answer a question this pack does not cover — via
ask_pipeworx, which routes across the whole catalog — without you adding a
second MCP server. There is currently no way to mount a pack endpoint without
them; if the extra schemas cost you more context than the routing is worth,
connect to the full gateway once rather than to several pack endpoints.
Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Both URLs reach the same gateway and the same 1476+ data sources. The
only difference is which pack's tools are listed directly; ask_pipeworx
reaches all of them from either one.
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:
ask_pipeworx({ question: "your question about Linear data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
