Linear Todo Sync

Fetch open Linear tasks and generate a prioritized markdown todo list.

1.3k|150|Updated Jun 13, 2025
One-click install
npx skills add https://github.com/qdhenry/Claude-Command-Suite --skill linear-todo-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Linear Todo Sync
Source: https://github.com/qdhenry/Claude-Command-Suite/tree/main/.claude/skills/linear-todo-sync
Command: npx skills add https://github.com/qdhenry/Claude-Command-Suite --skill linear-todo-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, mdutils, python-dotenv, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill eliminates the tedious manual work of checking Linear for your assigned tasks, prioritizing them, and keeping track of your daily workload. It automates the process of generating a clear, organized todo list, allowing you to immediately understand your priorities and focus on what matters most.

Core Features & Use Cases

  • Automated Task Sync: Fetches all open tasks assigned to the user from the Linear API.
  • Prioritized Todo List: Generates a markdown file grouped by project and priority (Urgent, High, Medium, Low), highlighting overdue items.
  • Rich Metadata: Includes task status, labels, story point estimates, due dates, and direct links to Linear issues.
  • Use Case: Start your day by asking Claude "What do I need to work on today?". The skill instantly provides a comprehensive, prioritized list of your tasks, so you know exactly where to focus without ever opening the Linear web app.

Quick Start

1. Install dependencies:

pip install requests mdutils python-dotenv

2. Configure Linear API Key:

Create a .env file in your project root. (Get your API key from: https://linear.app/settings/api) Add: LINEAR_API_KEY=lin_api_your_key_here Ensure .env is in your .gitignore to protect your key.

3. Trigger the skill:

Ask Claude: "What do I need to work on today?" Alternatively, run the script directly from your project root: python .claude/skills/linear-todo-sync/scripts/sync_linear_tasks.py

Frequently Asked Questions about Linear Todo Sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically sync my Linear tasks into a todo list?

Sync your Linear tasks by configuring your API key in a .env file, then running the script to fetch all open assigned tasks. The Skill generates a markdown todo list grouped by project and priority, with metadata like due dates, estimates, and status included.

Can I use Linear's GraphQL API to pull my assigned tasks?

Yes. The Skill uses Linear's GraphQL API with your LINEAR_API_KEY to retrieve all open tasks assigned to you. It handles authentication, rate limits, and network errors automatically.

What metadata does the generated todo list include?

The markdown todo list includes task status, priority level, labels, story point estimates, due dates, and direct URLs to each Linear issue, organized by project and sorted by urgency.

How do I set up the Linear API key without exposing it?

Create a .env file in your project root, add LINEAR_API_KEY=your_key, and ensure .env is in .gitignore. The Skill loads the key securely using python-dotenv before making API calls.

What happens if the Linear API is rate-limited or unreachable?

The Skill includes robust error handling for authentication failures, rate limits, and network issues. It will catch these errors and report them clearly so you know when to retry.

Can I use this for daily standups and sprint planning?

Yes. The Skill is designed for daily standups, sprint planning, and workload reviews. Ask Claude "What do I need to work on today?" to instantly get a prioritized, organized view of your assigned tasks across all Linear projects.