11.9k Downloads
Overview
Provides managed-OAuth access to the Linear GraphQL API via the Maton gateway, allowing agents to query and manage issues, projects, teams, cycles, labels, users, and comments in Linear workspaces.
Key Advantages
1.Managed OAuth: Maton gateway injects Linear OAuth tokens automatically, so the agent only needs a Maton API key (MATON_API_KEY).
2.Full GraphQL access: Supports Linear’s native GraphQL API, enabling flexible queries, filters, and mutations over most Linear entities.
3.Coverage of key entities: Includes examples for issues, projects, teams, cycles, labels, workflow states, users, and comments.
4.Good documentation: Clear quick-start, Python/JavaScript samples, pagination patterns, and error semantics (400/401/403/429 pass-through).
5.Multi-connection support: Can target specific Linear connections via the Maton-Connection header, useful when users have multiple workspaces/accounts linked to Maton.
Security by design: Uses OAuth +’
Use Cases
- Create, update, and query Linear issues for task management, bug tracking, and feature planning.
- Search issues by text, filter by state/priority/title, and triage or re-prioritize work items programmatically.
- List and inspect projects, cycles, and workflow states to support sprint planning and status reporting.
- Manage labels and comments on issues to support collaboration, tagging, and communication within Linear.
- Fetch organization, teams, and user lists to map ownership, assign work, or build integrations that align tasks to teams and people.
Evaluation Scores
8.5
/ 10
Reliability
8.0
Functionality
9.0
Usability
8.7
Safety
8.5
Performance
8.0
Compatibility
8.5
Based on 1 evaluation · Latest: 3/19/2026
Download Trend
Loading...
Evaluation History (1)
8.5/103/19/2026▼
OS: linux-x64LLM: z-ai/glm-4.5-air
**Judgement:** A strong, production-appropriate Linear integration for agents that need to work with issues, projects, and related entities via GraphQL, provided the environment is correctly configured with a Maton API key and Linear OAuth connections.
**Key strengths:**
- Managed OAuth through Maton simplifies authentication and token handling.
- Broad coverage of Linear entities (issues, projects, teams, cycles, labels, comments, users) with concrete query/mutation examples.
- Clear guidance on pagination, error codes, and troubleshooting, which is helpful for robust agent behavior.
**Main risks / limitations:**
- Hard dependency on external credentials and setup: requires a valid `MATON_API_KEY` and at least one ACTIVE Linear connection; otherwise calls will fail (e.g., 400/401).
- Accesses potentially sensitive organization data; orchestration must ensure it’s only used when the user explicitly intends to operate on their Linear workspace and that workspace/account selection is correct.
- GraphQL flexibility means the agent must construct syntactically valid and scope-appropriate queries; invalid queries or missing scopes can cause 400/403 errors that need handling.
**Recommended scenarios:**
- Agents managing product/dev workflows: creating/updating issues, adjusting priorities and states, and adding comments in Linear.
- Assistants that help with project tracking and reporting by listing issues, projects, cycles, and workflow states and summarizing their status.
- Integrations that sync tasks between Linear and other systems (via additional skills) where Linear is the source of truth for engineering work items.
Comments (0)
No comments yet. Be the first!