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.
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
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 immediately. Blocked hides a tool from agents.
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.
Tool disabled: the owner has turned the tool off. Review tool access on the connection page.
Linear documentation is authoritative for MCP availability, workspace permissions, tools and rate limits.
Last modified on November 5, 2026
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"ApexGenius","description":"Connect one app to a supported AI client, then keep the account, available operations, and observed Activity clear.","colors":{"primary":"#0055FF","light":"#4C7FE5","dark":"#4C7FE5"},"logo":{"light":"https://mintcdn.com/apexgenius/PL1VOuYeZtypECmH/logo/apexgenius.svg?fit=max\u0026auto=format\u0026n=PL1VOuYeZtypECmH\u0026q=85\u0026s=ef6a088897a39f3ddbf23122743577fe","dark":"https://mintcdn.com/apexgenius/PL1VOuYeZtypECmH/logo/apexgenius-dark.svg?fit=max\u0026auto=format\u0026n=PL1VOuYeZtypECmH\u0026q=85\u0026s=90a72ff0da22baa182d13aa1ab8398d9","href":"https://www.apexgenius.ai"},"favicon":{"light":"https://mintcdn.com/apexgenius/PL1VOuYeZtypECmH/logo/apexgenius.svg?fit=max\u0026auto=format\u0026n=PL1VOuYeZtypECmH\u0026q=85\u0026s=ef6a088897a39f3ddbf23122743577fe","dark":"https://mintcdn.com/apexgenius/PL1VOuYeZtypECmH/logo/apexgenius-dark.svg?fit=max\u0026auto=format\u0026n=PL1VOuYeZtypECmH\u0026q=85\u0026s=90a72ff0da22baa182d13aa1ab8398d9"},"appearance":{"default":"system","strict":false},"background":{"color":{"light":"#FAF9F6","dark":"#15171B"}},"navbar":{"links":[{"icon":"blocks","href":"https://www.apexgenius.ai/connectors","label":"Connectors"},{"icon":"workflow","href":"https://www.gatechsolutionsllc.com/services/agentforce-consulting","label":"Implementation help"}],"primary":{"type":"button","label":"Connect it free","href":"https://www.apexgenius.ai/auth"}},"footer":{"socials":{"x":"https://x.com/ApexGeniusAI","linkedin":"https://www.linkedin.com/company/apexgenius","youtube":"https://www.youtube.com/@ApexGeniusAI"},"links":[{"header":"ApexGenius","items":[{"label":"Product","href":"https://www.apexgenius.ai/mcp"},{"label":"Connector catalog","href":"https://www.apexgenius.ai/connectors"},{"label":"Security","href":"https://www.apexgenius.ai/security"}]},{"header":"Implementation","items":[{"label":"GAT Solutions services","href":"https://www.gatechsolutionsllc.com/services"},{"label":"AI and Agentforce consulting","href":"https://www.gatechsolutionsllc.com/services/agentforce-consulting"},{"label":"Salesforce integrations","href":"https://www.gatechsolutionsllc.com/services/salesforce-integrations"}]},{"header":"Legal","items":[{"label":"Privacy","href":"https://www.apexgenius.ai/privacy"},{"label":"Terms","href":"https://www.apexgenius.ai/terms"}]}]},"fonts":{"family":"Urbanist"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":false},"integrations":{"ga4":{"measurementId":"G-7RKJ5X02QV"}},"errors":{"404":{"redirect":false,"title":"This route is not in the gateway docs","description":"Check the address or return to the [ApexGenius introduction](/getting-started/introduction)."}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"apexgenius","hasAudioNarration":false,"actualSubdomain":"apexgenius","customDomains":["docs.apexgenius.ai"],"gitSource":{"type":"github","owner":"ezscore","repo":"apexai","deployBranch":"main","contentDirectory":"content/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af73179bd8b0362cded89b8","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Connect apps","count":43},{"language":"default","tag":"Additional connector guides","count":33},{"language":"default","tag":"Connect an AI client","count":6},{"language":"default","tag":"Salesforce","count":5},{"language":"default","tag":"Start here","count":5},{"language":"default","tag":"Reference and support","count":4},{"language":"default","tag":"Governance and concepts","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--ag-canvas: #FAF9F6;--ag-surface: #FFFFFF;--ag-ink: #1A1A18;--ag-muted: #6B6B66;--ag-border: #E8E5DF;--ag-blue: #0055FF;--ag-blue-frame: rgb(0 85 255 / 18%);--ag-clay: #D97757}.dark{--ag-blue-frame: rgb(51 119 255 / 28%)}#navbar{border-bottom:1px solid var(--ag-blue-frame)}nav[aria-label=\"Pages\"]{border-right-color:var(--ag-blue-frame)}card{border-radius:14px}code-block{border-radius:14px}callout{border-radius:12px}@media (prefers-reduced-motion: reduce){*,*::before,*::after{scroll-behavior:auto!important;animation-duration:0.01ms!important;animation-iteration-count:1!important;transition-duration:0.01ms!important}}"}],"page":{"pagePath":"integrations/linear","slug":"/integrations/linear","pageMetadata":{"title":"Linear MCP Setup","description":"Authorize a Linear workspace through Linear's official hosted MCP, then read issues, projects and cycles and create or update work from your AI.","category":"integrations","order":105,"lastVerified":"2026-09-23","href":"/integrations/linear"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Authorize a Linear workspace through Linear’s official hosted MCP, then read issues, projects and cycles and create or update work from your AI.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,CodeBlock,Frame,Heading,OptimizedImage,Step,Steps,Table}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`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.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://www.apexgenius.ai/connectors/linear`,children:`Explore the Linear connector`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-you-need`,children:`What you need`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A Linear account with access to the workspace you want to connect`}),`\n`,_jsx(_components.li,{children:`Permission from your workspace admin if your organization limits MCP connections`}),`\n`,_jsx(_components.li,{children:`An ApexGenius account`}),`\n`]}),`\n`,_jsxs(Accordion,{title:`How to connect Linear`,id:`how-to-connect-linear`,children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Before you start`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`An account with permission to use the Linear resources you intend to connect.`}),`\n`]}),_jsxs(Steps,{children:[_jsx(Step,{title:`Open Linear in Connections`,children:_jsx(_components.p,{children:`Choose Connect, or Add connection when offered. Give the connection a name if prompted. If Gateway setup pending appears, contact ApexGenius support before continuing.`})}),_jsxs(Step,{title:`Choose the account and review access`,children:[_jsx(_components.p,{children:`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.`}),_jsx(Frame,{caption:`Linear names ApexGenius, its callback address and Read, Write access. Approve connects your workspace. Cancel stops without connecting.`,children:_jsx(OptimizedImage,{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`}})})]}),_jsx(Step,{title:`Review the connected account and resources`,children:_jsx(_components.p,{children:`Confirm the connected Linear workspace. Open Tools to review the issue, project, cycle and comment actions. Writes run right away, and Linear notifies subscribers.`})}),_jsx(Step,{title:`Check the connection`,children:_jsx(_components.p,{children:`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.`})})]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Try a first question with your AI agent`})}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`List my five most recently updated Linear issues. Read only; do not change anything.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`Compare the returned account and resource with Linear. Check the connection status separately from the result of the first read.`}),_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/guides/mcp-setup`,children:`Add your AI agent`}),` · `,_jsx(_components.a,{href:`https://linear.app/docs/mcp`,children:`Official Linear instructions`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`tools-and-the-linear-skill`,children:`Tools and the Linear skill`}),`\n`,_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Skills`}),` on the connection to read `,_jsx(_components.strong,{children:`Linear`}),`, or read that MCP prompt in a compatible AI client with `,_jsx(_components.code,{children:`prompts/get`}),`. It explains the first safe read, how writes run, and what cannot be undone.`]}),`\n`,_jsx(_components.p,{children:`Three ApexGenius tools reach Linear’s live catalog:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`ApexGenius tool`}),_jsx(_components.th,{children:`What it does`}),_jsx(_components.th,{children:`Access`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`linear_search_tools`})}),_jsx(_components.td,{children:`Lists the tools Linear publishes right now, with their schemas`}),_jsx(_components.td,{children:`Read`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`linear_call_read_tool`})}),_jsx(_components.td,{children:`Runs a tool only when Linear’s live catalog marks it read-only`}),_jsx(_components.td,{children:`Read`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`linear_call_tool`})}),_jsx(_components.td,{children:`Runs any other Linear tool, such as saving an issue or a comment`}),_jsx(_components.td,{children:`Write`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Linear documents these operations. Your AI finds the exact current list with `,_jsx(_components.code,{children:`linear_search_tools`}),`, and Linear may add tools.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Job`}),_jsx(_components.th,{children:`Reads`}),_jsx(_components.th,{children:`Writes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Issues`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`list_issues`}),`, `,_jsx(_components.code,{children:`get_issue`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`save_issue`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Projects`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`list_projects`}),`, `,_jsx(_components.code,{children:`get_project`}),`, `,_jsx(_components.code,{children:`get_status_updates`})]}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cycles`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`list_cycles`})}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Comments`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`list_comments`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`save_comment`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Teams and people`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`list_teams`}),`, `,_jsx(_components.code,{children:`list_users`})]}),_jsx(_components.td,{})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Your AI discovers the tools with `,_jsx(_components.code,{children:`apex_search_tools`}),`. Reads use `,_jsx(_components.code,{children:`apex_call_read_tool`}),`; changes use `,_jsx(_components.code,{children:`apex_call_write_tool`}),`.`]}),`\n`,_jsx(_components.p,{children:`Writes run immediately. Blocked hides a tool from agents.`}),`\n`,_jsx(Heading,{level:`2`,id:`undo-and-limits`,children:`Undo and limits`}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsxs(_components.p,{children:[`If a layer fails (the connection, the tools, or the skill), Linear is `,_jsx(_components.strong,{children:`partially ready`}),`. A saved sign-in by itself does not make the connector usable.`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Unavailable to this account:`}),` check that you are signed in to the intended ApexGenius account and refresh Connections.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Reconnect required:`}),` use the connection page to renew the saved authorization.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Wrong workspace:`}),` each Linear workspace needs its own connection. Add another connection and choose the other workspace in Linear.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`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.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Tool disabled:`}),` the owner has turned the tool off. Review tool access on the connection page.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://www.apexgenius.ai/connectors/linear`,children:`Explore the Linear connector`}),` · `,_jsx(_components.a,{href:`https://www.apexgenius.ai/connections/linear`,children:`Open Linear Connections`})]}),`\n`,_jsx(Heading,{level:`2`,id:`official-linear-documentation`,children:`Official Linear documentation`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(`a`,{href:`https://linear.app/docs/mcp`,target:`_blank`,rel:`noreferrer`,children:`Linear MCP server`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(`a`,{href:`https://linear.app/integrations/slack`,target:`_blank`,rel:`noreferrer`,children:`Commonly used Linear MCP tools`}),`\n`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Linear documentation is authoritative for MCP availability, workspace permissions, tools and rate limits.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Linear MCP Setup","description":"Authorize a Linear workspace through Linear's official hosted MCP, then read issues, projects and cycles and create or update work from your AI.","category":"integrations","order":105,"lastVerified":"2026-09-23","href":"/integrations/linear"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What you need","slug":"what-you-need","depth":2,"children":[]},{"title":"Tools and the Linear skill","slug":"tools-and-the-linear-skill","depth":2,"children":[]},{"title":"Undo and limits","slug":"undo-and-limits","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Official Linear documentation","slug":"official-linear-documentation","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"apexgenius","siteName":"ApexGenius","title":"Linear MCP Setup - ApexGenius","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T12:31:35.026Z","gitLastModified":"2026-11-05T12:27:26.000Z","originalFileLocation":"integrations/linear.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Authorize a Linear workspace through Linear\u0026#x27;s official hosted MCP, then read issues, projects and cycles and create or update work from your AI.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ApexGenius\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Linear MCP Setup - ApexGenius\">\u003cmeta data-mint-head property=\"og:description\" content=\"Authorize a Linear workspace through Linear\u0026#x27;s official hosted MCP, then read issues, projects and cycles and create or update work from your AI.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ApexGenius\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apexgenius.ai/integrations/linear\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://apexgenius.mintlify.site/_mintlify/api/og/v2?division=Additional+connector+guides\u0026amp;title=Linear+MCP+Setup\u0026amp;description=Authorize+a+Linear+workspace+through+Linear%27s+official+hosted+MCP%2C+then+read+issues%2C+projects+and+cycles+and+create+or+update+work+from+your+AI.\u0026amp;theme=e9cacdcddfe6260e9743e25e\u0026amp;signature=5e72782d8168ab237335ec317020cd27615fa4b8c430592d0717f8a888c4d2a8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Linear MCP Setup - ApexGenius\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Authorize a Linear workspace through Linear\u0026#x27;s official hosted MCP, then read issues, projects and cycles and create or update work from your AI.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apexgenius.mintlify.site/_mintlify/api/og/v2?division=Additional+connector+guides\u0026amp;title=Linear+MCP+Setup\u0026amp;description=Authorize+a+Linear+workspace+through+Linear%27s+official+hosted+MCP%2C+then+read+issues%2C+projects+and+cycles+and+create+or+update+work+from+your+AI.\u0026amp;theme=e9cacdcddfe6260e9743e25e\u0026amp;signature=5e72782d8168ab237335ec317020cd27615fa4b8c430592d0717f8a888c4d2a8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ApexGenius\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0055FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.apexgenius.ai/integrations/linear\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/integrations/linear.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.apexgenius.ai/#organization\",\"name\":\"ApexGenius\",\"url\":\"https://docs.apexgenius.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/apexgenius/PL1VOuYeZtypECmH/logo/apexgenius.svg?fit=max\u0026auto=format\u0026n=PL1VOuYeZtypECmH\u0026q=85\u0026s=ef6a088897a39f3ddbf23122743577fe\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.apexgenius.ai#website\",\"name\":\"ApexGenius\",\"url\":\"https://docs.apexgenius.ai\",\"publisher\":{\"@id\":\"https://docs.apexgenius.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.apexgenius.ai/integrations/linear#webpage\",\"url\":\"https://docs.apexgenius.ai/integrations/linear\",\"name\":\"Linear MCP Setup\",\"description\":\"Authorize a Linear workspace through Linear's official hosted MCP, then read issues, projects and cycles and create or update work from your AI.\",\"dateModified\":\"2026-11-05T12:27:26.000Z\",\"isPartOf\":{\"@id\":\"https://docs.apexgenius.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apexgenius.ai/integrations/linear#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apexgenius.ai/integrations/linear#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connect apps\",\"item\":\"https://docs.apexgenius.ai/integrations/provider-connections\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Additional connector guides\",\"item\":\"https://docs.apexgenius.ai/integrations/hq-rental\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Linear MCP Setup\",\"item\":\"https://docs.apexgenius.ai/integrations/linear\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.apexgenius.ai/integrations/linear#article\",\"headline\":\"Linear MCP Setup\",\"name\":\"Linear MCP Setup\",\"description\":\"Authorize a Linear workspace through Linear's official hosted MCP, then read issues, projects and cycles and create or update work from your AI.\",\"url\":\"https://docs.apexgenius.ai/integrations/linear\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apexgenius.ai/integrations/linear#webpage\"},\"dateModified\":\"2026-11-05T12:27:26.000Z\",\"publisher\":{\"@id\":\"https://docs.apexgenius.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.apexgenius.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ApexGenius\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ApexGenius\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/integrations/linear.md","siteName":"ApexGenius","nav":{"global":null,"groups":[{"group":"Start here","icon":"route","pages":[{"title":"Connect one app to the AI you already use","href":"/getting-started/introduction"},{"title":"Connect an AI client","href":"/guides/mcp-setup"},{"title":"Send the first safe request","href":"/guides/first-safe-request"},{"title":"Skills","href":"/guides/skills"},{"title":"Memory","href":"/guides/memory"}]},{"group":"Connect an AI client","icon":"message-square-code","pages":[{"title":"Connect Claude","href":"/guides/connect-claude"},{"title":"Connect ChatGPT","href":"/guides/connect-chatgpt"},{"title":"Connect Codex","href":"/guides/connect-codex"},{"title":"Connect Cursor","href":"/guides/connect-cursor"},{"title":"Connect VS Code","href":"/guides/connect-vscode"},{"title":"Connect Claude Code","href":"/guides/connect-claude-code"}]},{"group":"Salesforce","icon":"cloud","pages":[{"title":"Connect Salesforce","href":"/getting-started/connect-salesforce"},{"title":"Loading Metadata","href":"/getting-started/load-metadata"},{"title":"Using the Account App","href":"/getting-started/using-chat"},{"title":"Reports and Dashboards: Current Availability","href":"/guides/reports-and-dashboards"},{"title":"Salesforce connection model","href":"/integrations/salesforce-connection"}]},{"group":"Connect apps","icon":"plug-zap","pages":[{"title":"App connection guides","href":"/integrations/provider-connections"},{"title":"YouTube MCP Setup","href":"/integrations/youtube"},{"title":"YouTube Analytics MCP Setup","href":"/integrations/youtube-analytics"},{"title":"n8n MCP Setup","href":"/integrations/n8n"},{"title":"Confluence MCP Setup","href":"/integrations/confluence"},{"title":"Discord MCP Setup","href":"/integrations/discord"},{"title":"Jira MCP Setup","href":"/integrations/jira"},{"group":"Additional connector guides","icon":"flask-conical","pages":[{"title":"HQ Rental MCP Setup","href":"/integrations/hq-rental"},{"title":"Google Ads MCP Setup","href":"/integrations/google-ads"},{"title":"Google Search Console MCP Setup","href":"/integrations/google-search-console"},{"title":"Google Analytics MCP Setup","href":"/integrations/google-analytics"},{"title":"Google Workspace MCP Setup","href":"/integrations/google-workspace"},{"title":"Upwork MCP Setup","href":"/integrations/upwork"},{"title":"Apollo MCP Setup","href":"/integrations/apollo"},{"title":"Notion MCP Setup","href":"/integrations/notion"},{"title":"Connect Slack accounts","href":"/integrations/slack"},{"title":"ClickUp MCP Setup","href":"/integrations/clickup"},{"title":"Connect Blotato","href":"/integrations/blotato"},{"title":"Connect HighLevel","href":"/integrations/gohighlevel"},{"title":"ChatGPT Ads MCP Setup","href":"/integrations/chatgpt-ads"},{"title":"Semrush MCP Setup","href":"/integrations/semrush"},{"title":"Bing Webmaster MCP Setup","href":"/integrations/bing-webmaster"},{"title":"Apify MCP Setup","description":"Connect your Apify account through Apify's official hosted MCP, find and run Actors from your AI, read results, and stop runs.","href":"/integrations/apify"},{"title":"Linear MCP Setup","href":"/integrations/linear"},{"title":"Attio MCP Setup","description":"Connect an Attio workspace to ApexGenius through Attio's official hosted MCP, read your CRM from your AI, and create or update records, notes and tasks.","href":"/integrations/attio"},{"title":"Calendly MCP Setup","href":"/integrations/calendly"},{"title":"Connect Cal.com to your AI","href":"/integrations/cal-com"},{"title":"Mobbin MCP Setup","href":"/integrations/mobbin"},{"title":"Supabase MCP Setup","href":"/integrations/supabase"},{"title":"Context.dev MCP Setup","href":"/integrations/context-dev"},{"title":"Stripe MCP Setup","href":"/integrations/stripe"},{"title":"GitHub MCP Setup","href":"/integrations/github"},{"title":"monday.com MCP Setup","href":"/integrations/monday"},{"title":"Atlassian Rovo MCP Setup","href":"/integrations/atlassian-rovo"},{"title":"ElevenLabs MCP Setup","href":"/integrations/elevenlabs"},{"title":"FreshBooks MCP Setup","href":"/integrations/freshbooks"},{"title":"Trello MCP Setup","href":"/integrations/trello"},{"title":"GitLab MCP Setup","href":"/integrations/gitlab"},{"title":"TypeSafe MCP Setup","href":"/integrations/typesafe"},{"title":"HubSpot MCP Setup","href":"/integrations/hubspot"}]},{"title":"Connect Speedrun Alpha","href":"/integrations/speedrun"},{"title":"Connect OP.GG to your AI","href":"/integrations/opgg"},{"title":"Read Polymarket information with your AI","href":"/integrations/polymarket"}]},{"group":"Governance and concepts","icon":"shield-check","pages":[{"title":"How the MCP Connection Works","href":"/concepts/how-mcp-works"},{"title":"Orgs, Projects \u0026 Workspaces","href":"/concepts/orgs-and-projects"},{"title":"The Soul Doc","href":"/concepts/soul-doc"}]},{"group":"Reference and support","icon":"book-open-check","pages":[{"title":"MCP Tool Reference","href":"/reference/mcp-tools"},{"title":"Pricing and Account Limits","href":"/reference/plans-and-limits"},{"title":"Common Issues","href":"/troubleshooting/common-issues"},{"title":"How we record your signup source","href":"/reference/signup-source"}]}]},"basePath":"","title":"Linear MCP Setup - ApexGenius","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D2acuaLg.js","DynamicMarkdown-Co5nikxh.js","zoom-image-lightbox-BbK2OBGL.js","lightbox-handle-r17bVUz3.js"]}