Create issues, list projects, manage sprints, and query teams via Linear GraphQL API
120+ deploysclaude mcp add linear --url https://datafaucet.dev/api/mcp/t/linear
Run this command in your terminal · most users connect in under 60s
list_issues
List 20 most recently updated issues with state (Triage/Backlog/Todo/In Progress/Done/Canceled), priority (0-4), assignee name, and identifier (e.g. ENG-123). Filter by team with 'filter' argument. Paginate with 'after' cursor from pageInfo.endCursor.
https://api.linear.app/graphql
list_teams
List all workspace teams with ID, display name, and short key prefix (e.g. 'ENG', 'DES'). Team ID is required for creating issues. Key appears in issue identifiers (KEY-123).
https://api.linear.app/graphql
list_projects
List 20 most recent projects with state (planned/started/paused/completed/canceled), progress as 0.0-1.0 float, and name. Projects group related issues across teams. Use project ID to filter issues.
https://api.linear.app/graphql
create_issue
Create an issue with title, team_id (from list_teams), and priority (0=none, 1=urgent, 2=high, 3=medium, 4=low). Returns issue ID, human-readable identifier (ENG-123), and direct URL. Optional: description (markdown), assigneeId, labelIds, projectId.
https://api.linear.app/graphql
list_cycles
List 5 most recent sprint cycles with name, ISO start/end dates, and progress (0.0-1.0). Cycles auto-advance based on schedule. Use cycle ID to filter issues within a sprint.
https://api.linear.app/graphql
list_labels
List all issue labels with ID, name, and hex color. Labels categorize issues (bug, feature, improvement). Use label IDs when creating or updating issues via labelIds array.
https://api.linear.app/graphql
list_workflow_states
List all workflow states across teams. Each state has type (triage/backlog/unstarted/started/completed/canceled), name (custom per team), and team key. Use state ID to update issue status.
https://api.linear.app/graphql
update_issue_state
Move an issue to a different workflow state. Requires issue_id (from list_issues) and state_id (from list_workflow_states). Returns updated issue with new state name. Common flow: move from backlog to in-progress to done.
https://api.linear.app/graphql
Run this in your terminal:
claude mcp add linear https://datafaucet.dev/api/mcp/t/linear
Connect Linear to your AI agent in under 60 seconds. No account required.
{notion_token}) with your real credentialsNeed API keys? Try our free sandbox templates first to see MCP in action with zero setup.
Replace these placeholders with your real values before deploying:
{issue_id}Resource identifier{linear_api_key}API settings page{priority}Your value{state_id}Resource identifier{team_id}Resource identifier{title}Your valuePreview:
POST https://api.linear.app/graphql Authorization: {linear_api_key} Content-Type: application/json {"query":"{ issues(first: 20, orderBy: updatedAt) { nodes { id title state { name } priority assignee { name } } } }"}
claude mcp add linear --url https://datafaucet.dev/api/mcp/t/linearWhat your AI agent sees
I have access to 8 tools from Linear: list_issues, list_teams, list_projects, and 5 more.
“List 20 most recently updated issues with state (Triage/Backlog/Todo/In Progress/Done/Canceled), priority (0-4), assignee name, and identifier (e.g. ENG-123). Filter by team with 'filter' argument. Paginate with 'after' cursor from pageInfo.endCursor.”
Calling list_issues... Done. Here are the results.
Try these prompts
“Create a bug ticket for the login page crash, assign it to the frontend team”
Copy“Show me all issues in the current sprint that are blocked”
Copy“Move all 'In Review' issues to 'Done' for the current cycle”
CopyClick any prompt to copy, then paste into your AI client.