# Linear

> Read and manage Linear issues.

Lets an agent read and manage issues in Linear via their GraphQL API.

## What it can do

| Method | What it does |
| --- | --- |
| `linear_viewer` | Authenticated Linear user - id, name, email, displayName. |
| `linear_list_teams` | List teams: id, key, name. |
| `linear_list_issues` | List issues; team_id (UUID) optional. Returns id, identifier, title, url, state. |
| `linear_get_issue` | Get one issue by UUID id. |
| `linear_create_issue` | Create an issue inside a team (team_id = UUID). |
| `linear_update_issue` | Update issue title, description and/or state_id (status UUID). |

## How to connect

Linear uses OAuth - there is no API key to paste.

1. Add the Linear MCP to your agent in FlyMyAI.
2. Click **Connect Linear**.
3. You're sent to Linear's consent screen - sign in and **Authorize** FlyMyAI.
4. You land back in FlyMyAI and the connection shows as active.

That's it - the agent now acts on your behalf in Linear. No fields to fill,
and nothing to copy. To revoke access later, remove FlyMyAI from
[linear.app/settings/account/security](https://linear.app/settings/account/security)
or just disconnect the MCP in FlyMyAI.

## Troubleshooting

- **`AUTHENTICATION_REQUIRED`** - the OAuth connection expired or was
  revoked. Disconnect and click **Connect Linear** again to re-authorize.
- **`issue not found`** - Linear IDs are UUIDs. If you only have the
  human key (`ENG-123`), fetch the UUID via `linear_list_issues`.

## Links

- [Linear security & connected apps](https://linear.app/settings/account/security)
- [GraphQL API docs](https://developers.linear.app/docs/graphql)