> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apexgenius.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear MCP Setup

> Authorize a Linear workspace through Linear's official hosted MCP, then read issues, projects and cycles and create or update work from your AI.

**Status: Available.** Linear uses its official hosted MCP server and browser OAuth. You do not paste a Linear API key. One connection covers one Linear workspace; your Linear permissions set what it can reach.

[Explore the Linear connector](https://www.apexgenius.ai/connectors/linear).

## What you need

* A Linear account with access to the workspace you want to connect
* Permission from your workspace admin if your organization limits MCP connections
* An ApexGenius account

<Accordion title="How to connect Linear">
  **Before you start**

  * An account with permission to use the Linear resources you intend to connect.

  <Steps>
    <Step title="Open Linear in Connections">
      Choose Connect, or Add connection when offered. Give the connection a name if prompted. If Gateway setup pending appears, contact ApexGenius support before continuing.
    </Step>

    <Step title="Choose the account and review access">
      Sign in to Linear in the browser, choose the workspace, and approve read and write access. Linear uses browser authorization; no API key is pasted into ApexGenius. Each workspace needs its own connection.

      <Frame caption="Linear names ApexGenius, its callback address and Read, Write access. Approve connects your workspace. Cancel stops without connecting.">
        <img src="https://www.apexgenius.ai/images/integration-guides/linear/20260923-review-access.webp" alt="The full Linear consent page, ApexGenius is requesting access, with red boxes around the details table and the Approve button." width="1323" height="896" style={{ width: '100%', height: 'auto' }} />
      </Frame>
    </Step>

    <Step title="Review the connected account and resources">
      Confirm the connected Linear workspace. Open Tools to review the issue, project, cycle and comment actions. Writes run right away, and Linear notifies subscribers.
    </Step>

    <Step title="Check the connection">
      Use Test connection or Check again and read the reported status. Add an AI agent from the AI agents page, choose Read only for the first test, and try the question below.
    </Step>
  </Steps>

  **Try a first question with your AI agent**

  ```text theme={"system"}
  List my five most recently updated Linear issues. Read only; do not change anything.
  ```

  Compare the returned account and resource with Linear. Check the connection status separately from the result of the first read.

  [Add your AI agent](/guides/mcp-setup) · [Official Linear instructions](https://linear.app/docs/mcp)
</Accordion>

## Tools and the Linear skill

Open **Skills** on the connection to read **Linear**, or read that MCP prompt in a compatible AI client with `prompts/get`. It explains the first safe read, how writes run, and what cannot be undone.

Three ApexGenius tools reach Linear's live catalog:

| ApexGenius tool         | What it does                                                     | Access |
| ----------------------- | ---------------------------------------------------------------- | ------ |
| `linear_search_tools`   | Lists the tools Linear publishes right now, with their schemas   | Read   |
| `linear_call_read_tool` | Runs a tool only when Linear's live catalog marks it read-only   | Read   |
| `linear_call_tool`      | Runs any other Linear tool, such as saving an issue or a comment | Write  |

Linear documents these operations. Your AI finds the exact current list with `linear_search_tools`, and Linear may add tools.

| Job              | Reads                                                | Writes         |
| ---------------- | ---------------------------------------------------- | -------------- |
| Issues           | `list_issues`, `get_issue`                           | `save_issue`   |
| Projects         | `list_projects`, `get_project`, `get_status_updates` |                |
| Cycles           | `list_cycles`                                        |                |
| Comments         | `list_comments`                                      | `save_comment` |
| Teams and people | `list_teams`, `list_users`                           |                |

Your AI discovers the tools with `apex_search_tools`. Reads use `apex_call_read_tool`; changes use `apex_call_write_tool`.

Writes run right away. If the owner set a tool to Ask me first (approval mode always), the call returns `approval_required`; a person approves it in ApexGenius and you retry with the returned `approval_request_id`.

## Undo and limits

ApexGenius cannot undo a Linear change. To reverse an edit, save the old value back. Linear notifies subscribers of new issues and comments, and a sent notification cannot be recalled. Disconnecting stops future gateway access; it does not reverse work that already ran.

If a layer fails (the connection, the tools, or the skill), Linear is **partially ready**. A saved sign-in by itself does not make the connector usable.

## Troubleshooting

* **Unavailable to this account:** check that you are signed in to the intended ApexGenius account and refresh Connections.
* **Reconnect required:** use the connection page to renew the saved authorization.
* **Wrong workspace:** each Linear workspace needs its own connection. Add another connection and choose the other workspace in Linear.
* **A read is refused as not read-only:** Linear's live catalog did not mark that tool read-only. Discover tools again; do not route a change through the read tool.
* **Approval required:** the tool is set to Ask me first. Review the exact change in ApexGenius, then retry.

[Explore the Linear connector](https://www.apexgenius.ai/connectors/linear) · [Open Linear Connections](https://www.apexgenius.ai/connections/linear)

## Official Linear documentation

* <a href="https://linear.app/docs/mcp" target="_blank" rel="noreferrer">Linear MCP server</a>
* <a href="https://linear.app/integrations/slack" target="_blank" rel="noreferrer">Commonly used Linear MCP tools</a>

Linear documentation is authoritative for MCP availability, workspace permissions, tools and rate limits.