Tana connects to your Linear workspace so the AI can turn what you discuss into filed and updated issues, without you switching tools. Talk through a bug or a task in a meeting or in chat, and the issue gets created while the context is fresh. This guide walks through the one-time setup, what to expect from the authorization flow, and how to start using the integration in chat.

What you can do with Linear in Tana

Once Linear is connected, ask the AI in chat to:

Create issues: file a new issue in a team, with title, description, priority, labels, assignee, and project
Update issues: change fields on an existing issue, or move it to a new workflow state
Search issues: look up existing issues by keyword, useful for checking duplicates before you file a new one
List teams: see the teams you have access to, so issues land in the right place
Attach meeting screenshots: include screenshots shared on a call in the issue description, so it keeps its visual context

You can also attach skills to Tana types that drive Linear actions one-click from your documents. See Skills for how that works.

Connect Linear

You only need to do this once. The connection is per-account, not org-wide.

Open Settings with Cmd+,Ctrl+,, or from the account menu in the sidebar.
Open Integrations.
Find Linear under personal integrations and click Connect.
A Linear authorization window opens. Sign in if you aren't already.
Review the access Linear lists for Tana, then approve it.
The window closes and Tana shows Connected next to Linear.

Permissions Tana requests

Tana asks Linear for the access it needs to work with your issues: reading your teams and issues, and creating or updating issues. Tana never reads or writes anything outside what you approve during connect.

Your access token is stored securely on Tana's servers, never in your browser.

You can review or revoke Tana's access at any time from your Linear account settings.

Use it in chat

Once Linear is connected, the AI can call Linear tools when a prompt asks for it. Some prompts to try:

"Check Linear for open issues about the login bug, then file a new one if there isn't a duplicate."
"Create a Linear issue on the Web team: write up the bug we just discussed and set priority to High."
"Move ENG-241 to In Review."
"What teams do I have access to in Linear?"

The AI picks the right Linear tool from your prompt and asks for clarification when something is ambiguous, for example which team, or which of two similar issues.

How Tana files an issue

A few things happen automatically when the AI creates or updates an issue:

Duplicate check: when you ask it to, the AI searches existing issues first, so you don't file the same bug twice.
Formatted descriptions: the AI writes the description in markdown, which Linear renders natively.
Screenshots as context: if the issue comes from a meeting, the AI can embed screenshots shared on the call in the description.

To change status, the AI moves the issue to another workflow state in its team.

Disconnect Linear

To remove the connection from Tana:

Open Settings → Integrations.
Open the Connected menu next to Linear and choose Disconnect. The same menu has Reconnect, which you can use to refresh access.

Disconnecting stops the AI from reading or writing to Linear but does not change anything already in Linear or in Tana. To fully revoke Tana's access from Linear's side, also revoke it from your Linear account settings.

Troubleshooting

The AI says it can't reach Linear. The connection has likely expired or been revoked. Reconnect from Settings → Integrations.

You're not sure where an issue landed. The AI returns a link to each issue it creates, so open that to jump straight to it in Linear.

A status change didn't work. The AI can only move an issue to a workflow state that exists in its team. If the state you want isn't there, set it in Linear directly.

Something else? See Integrations for the broader integration overview, or reach out at support@tana.inc.