List issues

List issues

Returns the issues that match a filter on fields such as assignee, label, status, project or priority, one page at a time.

Note: Returns 50 issues at a time by default: pass pageInfo.endCursor as after for the next page.

Set up

Use the first option your agent supports.

MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

{ "mcpServers": { "linear": { "url": "https://mcp.linear.app/mcp" } } }

Call the MCP tool list_issues.

Server URL: https://mcp.linear.app/mcp

API (official)

• Base URL: https://api.linear.app
• Endpoint: POST /graphql
• Auth: send the header Authorization: $LINEAR_API_KEY
• Get a key: https://linear.app/settings/account/security
• Docs: https://linear.app/developers/graphql

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

Rules

• Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
• Never print API keys.