Skip to content

Linear MCP and API

Linear lets authorized applications read and change issues, projects and cycles in a workspace. An agent can read issues and create work items in the connected workspace. Connect your Linear account once with OAuth in Longwave; agents act only on that account.

Add to Longwave

Install elsewhere

Install Linear

Choose a harness. These instructions connect to the hosted MCP endpoint shown on this page.

Claude Code

Run this in your terminal. It adds a user-scoped server; use --scope project instead if it should apply only to the current project.

terminal
claude mcp add --scope user --transport http linear https://mcp.linear.app/mcp
access
Connect account

Use Linear on Longwave

  1. Download Longwave or open app.longwave.run.
  2. Sign in to Linear the first time an agent uses the server.
  3. Ask for the result in any thread, for example: “List issues for a release planning brief”. The agent picks the Linear function and calls it.

Use cases

Questions people ask

Does Linear use REST or GraphQL?

Linear exposes a GraphQL API. Queries read workspace data and mutations create or change records. Linear documentation

How does Linear paginate API results?

Linear uses cursor pagination for connections. Requests can specify a result count and a cursor to continue through a collection. Linear documentation

How do I add the Linear MCP server to Claude Code?

Run claude mcp add --transport http linear https://mcp.linear.app/mcp in a terminal. Sign in to Linear the first time an agent uses the server.

Who publishes the Linear MCP server?

Linear publishes the Linear MCP server that Longwave installs.

Use Linear in Longwave

Call Linear from any agent thread, on your machine or in the cloud.

Add to Longwave