# Linear MCP

> Find, create and update Linear issues, projects and comments from your agent, through Linear's hosted MCP server.

Linear's own MCP server gives your agent simple, secure access to your Linear workspace. Linear hosts and runs it, and its tools find, create and update issues, projects and comments, so you can plan and track work by asking in plain words.

What you can do with it
- Turn a planning document into a project, with issues, milestones and the links between them
- Post standup notes as comments on the issues they're about
- Investigate a bug from its issue, then write the findings back as a comment
- Sum up what a team finished in its last cycle
- Build a timeline of the work around a project, incident or topic
- Draft an implementation plan, then create the parent issue and its sub-issues

How it connects
Linear hosts the server at https://mcp.linear.app/mcp. The first time your agent uses it, you sign in with your Linear account and approve access. You can also pass a Linear API key or OAuth token as a bearer token instead. Linear's docs walk through setup in Claude, Claude Code, Codex, Cursor, VS Code, Windsurf, Zed and more; agents without remote MCP support can reach it through mcp-remote.

Read-only when you want it
Connect to https://mcp.linear.app/mcp/readonly, which only ever exposes read tools, or grant only the read scope, and your agent can look things up but can't change anything. An API key with only the Read permission works the same way.

Good to know
Each sign-in covers one Linear workspace, so a second workspace needs its own connection. Teams on Okta can turn on enterprise-managed sign-in, so supported agents such as Claude authenticate through your Okta policies.

- Type: Plugin
- Made by: Linear
- Category: Project management
- Formats: Remote MCP
- Version: 1.0.2
- Website: https://linear.app/docs/mcp
- Page: https://pluginboard.ai/plugins/linear

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://mcp.linear.app/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://mcp.linear.app/mcp

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://mcp.linear.app/mcp. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://mcp.linear.app/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Gemini

In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://mcp.linear.app/mcp

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://mcp.linear.app/mcp and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22linear-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.linear.app%2Fmcp%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http linear-mcp https://mcp.linear.app/mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=linear-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5saW5lYXIuYXBwL21jcCJ9

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "linear-mcp": {
      "url": "https://mcp.linear.app/mcp"
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http linear-mcp https://mcp.linear.app/mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add linear-mcp --url https://mcp.linear.app/mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "linear-mcp": {
      "url": "https://mcp.linear.app/mcp"
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http linear-mcp https://mcp.linear.app/mcp
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://mcp.linear.app/mcp (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add linear-mcp --url https://mcp.linear.app/mcp --transport streamable-http
```

If it needs a key or sign-in: For https://mcp.linear.app/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login linear-mcp.

### OpenCode

Run in your terminal:

```shell
opencode mcp add linear-mcp --url https://mcp.linear.app/mcp
```

If it needs a key: For https://mcp.linear.app/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add linear-mcp --url https://mcp.linear.app/mcp
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "linear-mcp": {
      "url": "https://mcp.linear.app/mcp"
    }
  }
}
```

If it signs in with OAuth: If https://mcp.linear.app/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).