Lby Linear
List issues
Returns the issues that match a filter on fields such as assignee, label, status, project or priority, one page at a time.
Description
On the API, query `issues` with a `filter` built from comparators such as `eq`, `in` and `lte`, for example `assignee: { email: { eq: "..." } }`. Results come 50 at a time by default: pass `pageInfo.endCursor` as `after` to get the next page. `list_issues` pages its results as well.
list-issues.md
List issues
Returns the issues that match a filter on fields such as assignee, label, status, project or priority, one page at a time.
On the API, query issues with a filter built from comparators such as
eq, in and lte, for example assignee: { email: { eq: "..." } }.
Results come 50 at a time by default: pass pageInfo.endCursor as after to
get the next page. list_issues pages its results as well.
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 doing anything else, make one read-only call to confirm access.
Rules
- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.
Built from these files in the repository
The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.