Linear API

Modern project management API for software teams covering issues, projects, cycles, roadmaps, and team workflows via a rich GraphQL interface.

Evaluated Mar 06, 2026 (0d ago) vcurrent
Homepage ↗ Repo ↗ Developer Tools project-management graphql issues sprint roadmap developer-tools automation
⚙ Agent Friendliness
63
/ 100
Can an agent use this?
🔒 Security
87
/ 100
Is it safe for agents?
⚡ Reliability
84
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
0
Documentation
88
Error Messages
84
Auth Simplicity
82
Rate Limits
78

🔒 Security

TLS Enforcement
100
Auth Strength
85
Scope Granularity
85
Dep. Hygiene
82
Secret Handling
84

HTTPS enforced. OAuth scopes are well-defined and granular. Personal API keys should be treated as secrets. SOC2 Type II certified. GDPR compliant with EU data residency option.

⚡ Reliability

Uptime/SLA
88
Version Stability
85
Breaking Changes
82
Error Recovery
82
AF Security Reliability

Best When

A software engineering team uses Linear and an agent needs to automate issue management, triage, or status reporting.

Avoid When

Your team is not already on Linear, or you need REST-based integration without GraphQL capability.

Use Cases

  • Creating and updating issues programmatically from agent workflows
  • Syncing bug reports, alerts, or user feedback into Linear as issues
  • Querying sprint (cycle) state and roadmap progress for status reports
  • Automating triage, labeling, and assignment workflows
  • Building custom dashboards and integrations for engineering teams

Not For

  • Non-technical teams who prefer simple kanban tools like Trello
  • Orgs that need self-hosted project management with no cloud dependency
  • Large-scale helpdesk or customer support ticketing

Interface

REST API
No
GraphQL
Yes
gRPC
No
MCP Server
No
SDK
Yes
Webhooks
Yes

Authentication

Methods: api_key oauth
OAuth: Yes Scopes: Yes

Personal API keys for automation and agents. OAuth 2.0 apps for team integrations with granular scopes (read, write, issues, projects). OAuth is recommended for multi-user integrations.

Pricing

Model: freemium
Free tier: Yes
Requires CC: No

API access available on all tiers including free. Webhook and automation features may require paid plans.

Agent Metadata

Pagination
cursor
Idempotent
Partial
Retry Guidance
Documented

Known Gotchas

  • GraphQL-only API means agents must construct queries carefully; no REST fallback
  • Rate limit of 1,500 req/hour per key can be hit quickly by agents doing bulk operations
  • Team and workspace IDs are required for most mutations; agents must resolve these first
  • Webhook payloads use action types (create, update, remove) — agents must handle all three
  • The official SDK is TypeScript/JS only; Python agents must use raw GraphQL HTTP requests

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for Linear API.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-03-06.

5229
Packages Evaluated
26151
Need Evaluation
173
Need Re-evaluation
Community Powered