Linear

Tier

Once the Public switch is on, other workspaces can authorize the app straight away, and Linear's docs describe no review, verification or user cap before that.

Using Composio?

Composio has a managed Linear OAuth app, so you can prototype before you register your own. Register your own before launch so your app name shows on the consent screen. Composio's separate LINEAR_MCP toolkit needs your own OAuth app.LINEAR

Your workspace

Users see: Linear's authorization screen with your app name and the requested scopesNext: Turn on the Public switch (distribution: public) on the OAuth appDocs1, 3

Public app

Users see: The same authorization screen. Members of workspaces that require approval see a request screen until an admin approves the app.Docs3, 4, 6

Linear doesn't classify scopes or require approval for any of them. Request the narrowest set that works. The admin scope is the broadest one.

• readbasicRead access (always included). Nothing
• write / issues:create / comments:createbasicWrite access, or narrower create-only access. Nothing
• adminsensitiveAdmin-level endpoints. No review. Linear advises requesting it only when absolutely needed. Installing users likely need to be admins (not confirmed).

• Users from other workspaces can't install the app

  The app is still private, which is the default distribution.

  FixTurn on Public in the app settings.

  Docs3, 4

• 'Invalid redirect URI' at authorization

  The redirect_uri sent doesn't match any registered callback URL.

  FixAdd the exact URL under Callback URLs.

  Community8· medium confidence

• invalid_grant on refresh

  A stale refresh token was reused after rotation.

  FixSave the new refresh token after each refresh. Linear allows replaying the original request within 30 minutes if a response is lost.

  Docs1, 7

• A member sees an approval request screen instead of consent

  Their Enterprise workspace has third-party app approvals turned on.

  FixA workspace admin approves the app under workspace applications.

  Docs6· medium confidence

• Does making an app Public ever trigger a review by Linear?

  The docs describe the switch but say nothing about review.

  ResolveCreate a test app, turn on Public, and install it from a second workspace.

• Do actor=app installs or the admin scope require a workspace admin to authorize?

  Not confirmed in the pages fetched.

  ResolveCheck the Linear app/agent authentication docs, or test with a non-admin account.

• How long does a directory listing review take?

  Linear gives no timeline.

  ResolveAsk integrations@linear.app.

1. 1OAuth 2.0 authenticationLinear developer docs · Official docs · checked 27 Oct 2026
2. 2Integration directoryLinear developer docs · Official docs · checked 27 Oct 2026
3. 3OAuth app manifestsLinear developer docs · Official docs · checked 27 Oct 2026
4. 4How to register your own Linear API OAuth appNango docs · Community · checked 27 Oct 2026
5. 5Rate limitingLinear developer docs · Official docs · checked 27 Oct 2026
6. 6Third-Party Application ApprovalsLinear docs · Search results · not yet checked
7. 7Linear OAuth refresh token invalid_grantNango blog · Search results · not yet checked
8. 8Linear MCP auth fails with Invalid redirect URICursor forum · Search results · not yet checked
9. 9Managed auth toolkitsComposio docs · Composio docs · checked 27 Oct 2026