Docs
Home

Connecting Linear

Connect Linear so your agents can find and update issues on your behalf.

Connect Linear and your agents can find, create, and update issues and projects for you — without ever handling your password. You connect once with your own Linear sign-in, and agents use that access only when they act on your behalf.

Linear connects through Linear's official service, and setup is automatic — there's nothing to configure and no credentials to paste. You just approve access once.

Setting it up

There are two ways to set Linear up. A workspace admin can enable it once for everyone, or you can connect it just for yourself as a private connection.

Just for you (a personal connection):

  1. Open Settings → My Connections and find Linear in the Connectors section. Click Add to open the connector's page.
  2. In the Use it with your own account section, choose Add & connect.
  3. Sign in with Linear and approve the requested access. You'll be returned to Monad with Linear added to your private connections.

Admin (for the whole workspace):

  1. Open Settings → Agents → Connections and find Linear in the Connectors section. Click Add to open the connector's page.
  2. In the Workspace setup section, choose Enable for workspace.

Once an admin has enabled Linear, every member sees it ready to connect from Settings → Connection Preferences — they just click Add, then Connect, and approve access with their own Linear sign-in.

Once Linear is connected, its card turns into a dimmed Added tile and it shows up in your Connections list — open it from there any time to manage or disconnect it.

From then on you can ask an agent things like "what's assigned to me in Linear?" or "open a bug for the crash we just saw" without thinking about credentials.

What your agents can do

Your agents act as your account, with the same access to Linear that you have — searching, creating, and updating issues, projects, and comments. They can't do anything in Linear that you couldn't do yourself.

Reconnecting

If you see an amber Reconnect needed badge, your access expired or the permissions changed. Click Reconnect and approve again.

Disconnecting

Click Disconnect at any time and Monad immediately stops using your Linear account. Your connection is yours alone — other members can't use it, and admins can see only that you've connected, never your issues or your tokens.