Skip to main content
Linear is an issue tracker for software teams. Vibely connects to it in two separate ways, and you can use either or both:
  • App connector. Your published app reads and writes Linear while people use it: a public roadmap, or a bug report form that files issues.
  • Chat connector. Vibely reads your issues and specs while you build, so you can say Implement ENG-412 and it works from the real ticket.
Connect your app to Linear
Each is its own authorization. Connecting one doesn’t connect the other.

​
What you can build

With the app connector, your app can read issues, projects, cycles, and teams, and create and update issues.

​
Before you start

  • A Linear workspace and an account that can authorize apps in it.
  • Access to every team you want the connection to reach. The connection sees what the authorizing account sees.
  • Permission to add connectors in your Vibely workspace. See Admin controls.
Linear API usage counts against your Linear plan and its rate limits.

​
Connect Linear

1

Open the connector

In the sidebar, go to Customize → Connectors and select Linear.
2

Add a connection

Click Add connection, then connect. Vibely asks Linear for read and write access.
3

Authorize in Linear

Approve access in the Linear window that opens.
4

Ask for the feature

In the project chat, describe what you want, for example Build a public roadmap from my Linear projects.

​
How each connection works

App connector. The connection runs on one shared Linear account. Every visitor to your published app acts as that account. For a company app, authorize with an account that’s a member of every relevant team. Your app calls Linear through Vibely’s connector gateway, which holds the token, so the token never ships in your app’s code. Chat connector. The connection is personal to you. Only you can use it, it runs through Linear’s hosted MCP server, and it isn’t part of the app you publish.

​
Limitations

  • One shared account for the app connector. Every user of your published app acts as the account that authorized it.
  • Issue-level access only. write covers creating and updating issues and projects. It doesn’t cover workspace administration, such as members or billing.
  • Linear’s rate limits apply. Vibely passes them through to your app.

​
Manage or disconnect Linear

  • The app connection is under Customize → Connectors → Linear. Disconnecting it stops your published app from reaching Linear; the generated code stays and starts failing until you reconnect or remove it.
  • The chat connection is under Settings → Connectors. Removing it only stops Vibely from reading Linear while you build.
To revoke access from Linear’s side, remove the app in your Linear settings.

​
FAQ

No. Use the app connector if your published app needs Linear. Use the chat connector if you only want Vibely to work from your tickets while it builds.
No. The app connector uses one shared account for everyone who uses your app.
No. Chat connections are personal. Teammates connect their own Linear accounts.

Connectors

App and chat connectors explained.

Custom MCP servers

Connect a tool that isn’t in the catalog.

Notion

Another app and chat connector.

Admin controls

Who can add connectors.