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.
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
How to connect Linear
Before you start
An account with permission to use the Linear resources you intend to connect.
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.
Linear names ApexGenius, its callback address and Read, Write access. Approve connects your workspace. Cancel stops without connecting.
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.
Try a first question with your AI agent
List my five most recently updated Linear issues. Read only; do not change anything.
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.
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.
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.
