Skip to content

Connect Claude Code to Linear

Connect Claude Code to Linear in 3 steps: 1. Sign in to ApexGenius and connect Linear. 2. Add the ApexGenius MCP server. 3. Start using Linear in Claude Code.

1,000 free credits · No card required

How to connect Linear to Claude Code

  1. 1Sign in to ApexGenius and connect Linear
  2. 2Add the ApexGenius MCP server to Claude Code
  3. 3Start using Linear in Claude Code
  1. 1Linear

    Connect Linear to ApexGenius

    Connect Linear

    Linear opens its own sign-in. Sign in and allow ApexGenius.

  2. 2ApexGenius

    Connect ApexGenius to Claude Code

    Copy the MCP address

    On Start, pick API key, open Manual setup, and copy the MCP address.

  3. 3ApexGenius

     

    Approve access

    ApexGenius opens its approval page. Review the access, then approve.

Add the ApexGenius MCP server to Claude Code

Claude Code stores MCP servers in ~/.claude.json. With --scope user the server is available in every project. Without it, only in the project where you ran the command.

  1. Run the command. Claude Code prints an Added line.
  2. Start Claude Code, run /mcp, choose apexgenius and follow the sign-in in your browser. From a shell, claude mcp login apexgenius does the same.
  3. Approve access on the ApexGenius page.
Run in your terminal
claude mcp add --transport http --scope user apexgenius https://server.autom8.pro/mcp

Check it. Run claude mcp list. Each server shows a status, such as Connected or Needs authentication. claude mcp get apexgenius shows the detail.

Steps follow Claude Code documentation, Connect Claude Code to tools via MCP (opens in a new tab), read November 12, 2026.

Then ask Claude Code

List my five most recently updated Linear issues. Read only; do not change anything.

Start free
Written setup, step by stepShow

Before you start

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

1. Connect Linear to ApexGenius

  1. 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.
  2. 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.
    The full Linear consent page, ApexGenius is requesting access, with red boxes around the details table and the Approve button.
    Linear names ApexGenius, its callback address and Read, Write access. Approve connects your workspace. Cancel stops without connecting.Open full-size image (opens in a new tab)
  3. 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.
  4. 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.
Connect Linear →

2. Connect ApexGenius to Claude Code

Use this server address when adding the connection:

https://server.autom8.pro/mcp

The steps are above, under Add the ApexGenius MCP server to Claude Code. These notes apply to Claude Code only.

  • Over SSH or without a browser. claude mcp login apexgenius prints the authorization URL when it finds no local browser. Open it on your own machine, then paste the full redirect URL from the address bar back at the prompt. Add --no-browser to force that.
  • Headless runs. A claude -p run has no /mcp panel and cannot run the sign-in. Sign in once from an interactive session, or with claude mcp login, first.
  • Signing out. Clear authentication in the /mcp menu, or claude mcp logout apexgenius, removes the stored sign-in.
  • Access. When ApexGenius asks what Claude Code may use, choose Read only for the first test, or Custom to limit it to the tools you need.
A generated anonymous terminal illustration showing a setup command, ApexGenius added, browser authorization, and ready to use.
Generated terminal example. Use the exact copy button on this page; the image only shows what kind of screen to expect.Open full-size image (opens in a new tab)

3. Verify one safe read

List my five most recently updated Linear issues. Read only; do not change anything.

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.

Full guide: the Linear setup guide.

What it looks like in Claude Code

Illustration of a task, not a recorded customer result. Your answers come from the account and dates you choose.

How the route works
Claude Code
Claude CodeApexGenius MCP route
List my five most recently updated Linear issues. Read only; do not change anything.
ApexGenius
Working with ApexGenius1 tool search · 1 read
RequestRecent issues
Account scopeAuthorized connections checked
apex_search_toolsLinear issues · Find the Linear read routeComplete
apex_call_read_toollist_issues · List recently updated issuesComplete
Claude Code

Illustrative example: five issues changed in the last two days, each with its team, status and assignee. Compare the workspace with the one you connected. Nothing was changed.

Read-only route
Claude Code

What to ask Claude Code about Linear

  • Recent issues

    List my five most recently updated Linear issues. Read only; do not change anything.

    Runs list_issues (read).

  • Summarize a cycle

    Summarize what my team finished in the last completed cycle.

    Runs list_cycles (read), then list_issues (read).

  • Project status

    Read the latest status updates on the project I name and list the open risks.

    Runs list_projects (read), then get_status_updates (read).

These 3 questions use 4 of Linear’s 11 operations. The full list is below.

  • Create an issue in the team I name with this title and description. Show me the draft first. (write)

What Claude Code can do in Linear

11 operations: 9 read, 2 write. Read looks things up and changes nothing. Writes change Linear and run only when you turn them on.

Issues

2 read · 1 write
  • list_issuesread
  • get_issueread
  • save_issuewrite

Projects

3 read
  • list_projectsread
  • get_projectread
  • get_status_updatesread

Cycles

1 read
  • list_cyclesread

Comments

1 read · 1 write
  • list_commentsread
  • save_commentwrite

Teams and people

2 read
  • list_teamsread
  • list_usersread

You choose the access. When you approve Claude Code, pick Full access, Read only, or Custom.

One connection covers one Linear workspace. Connect again for another workspace.

Your Linear permissions set what the connection can reach. ApexGenius tool controls do not add Linear permissions.

The read route checks Linear’s live read-only label and rejects writes.

Writes run immediately. Blocked hides a tool from agents.

ApexGenius cannot undo a Linear change. Disconnecting stops future gateway access; it does not reverse an issue, update or comment that already ran.

Start free

Questions about connecting Claude Code to Linear

Updated November 12, 2026.

How do I connect Claude Code to Linear?

Connect Claude Code to Linear through ApexGenius in three steps. Sign in to ApexGenius and connect Linear by signing in to Linear in the browser and picking the workspace. In Claude Code, run claude mcp add --transport http --scope user apexgenius https://server.autom8.pro/mcp, then run /mcp and sign in. Then open a task in Claude Code and ask a question about your Linear. Start with a read, so nothing changes.

How do I check that Claude Code can use Linear?

Run claude mcp list in your terminal. apexgenius should show Connected. If it shows Needs authentication, run /mcp inside Claude Code, or claude mcp login apexgenius in your shell, and finish the browser sign-in. Then ask: “List my five most recently updated Linear issues. Read only; do not change anything.”

Is there a Linear MCP server for Claude Code?

Yes. ApexGenius is an MCP server that Claude Code connects to once. It carries your Linear connection and 11 Linear operations, so Claude Code does not need a separate Linear integration or plugin. You set it up one time and add each agent the same way.

What can Claude Code do in Linear once it is connected?

Claude Code can run 11 Linear operations through ApexGenius: 9 reads that find issues and read projects, status updates, cycles, comments, teams and people, and 2 writes that save issues and comments once you turn writes on. Linear permissions still apply.

Can Claude Code read my Linear workspace?

One workspace per connection, the one you pick when you sign in to Linear in the browser. Your Linear permissions set what Claude Code can reach, and ApexGenius adds none. Connect again to add another workspace. No Linear API key is pasted into ApexGenius.

Can Claude Code change my Linear?

Not until you allow writes. Choose Read only and reads go through a route that checks Linear’s read-only label. With writes on, Claude Code can create and update issues and add comments, and Linear notifies subscribers. ApexGenius cannot undo a Linear change.

Can I use the same Linear connection with Claude, ChatGPT, Grok Bot or Muse?

Yes. One Linear connection in ApexGenius works with every compatible agent you add, including Claude, ChatGPT, Grok Bot or Muse. Each agent gets its own access choice and its own short setup, so you can pick read only for one agent and more for another.

Connect Linear to Claude Code today

Start free

1,000 free credits. No card required. Disconnect any time.