Linear Todo Sync

This skill fetches open tasks assigned to the user from the Linear API and generates a markdown todo list file in the project root. This skill should be used when the user asks about their work items, wants to see what they need to work on, or requests to load/sync their Linear tasks. Requires Python 3.7+, requests, mdutils, and python-dotenv packages. Requires LINEAR_API_KEY in .env file.

932stars89forksUpdated 2/9/2026

Data Science & ML #task-management #todo-list #graphql #linear #python

Security Assessment

Critical Risk(0/100)

Detected risks:

Data Exfiltration([reference.md] requests.post)

Persistence([SKILL.md] .bashrc, [SKILL.md] .zshrc)

Secret Exposure([README.md] API_KEY=, [examples.md] API_KEY=, [SKILL.md] API_KEY=)

Sensitive File Access([reference.md] .env, [README.md] .env, [examples.md] .env)

Security Score0/100

About Linear Todo Sync

The Linear Todo Sync skill is designed to help users stay organized by automatically fetching open tasks assigned to them from the Linear API. It generates a markdown todo list in the project root that provides a comprehensive view of the user's tasks, making it easier to stay on top of their work. This skill is particularly useful for developers or team members who manage tasks in Linear and need a quick way to review their workload in a structured format.

FAQ

How do I set up the Linear Todo Sync skill?

You can set up the Linear Todo Sync skill by installing the required Python packages (`requests`, `mdutils`, `python-dotenv`), obtaining a Linear API key, and configuring the `.env` file in your project root. Detailed setup instructions are provided in the documentation.

What does the generated markdown file contain?

The generated markdown file contains a list of all open tasks assigned to you, grouped by project. Each task includes details such as title, description, status, priority, labels, estimates, due dates, and a link to the Linear issue.

Can I customize the tasks that are fetched?

Yes, you can customize the tasks by editing the `scripts/sync_linear_tasks.py` file. The GraphQL query can be modified to fetch additional fields or filter tasks in different ways.

What Python version is required?

This skill requires Python 3.7 or higher.

Are there any other requirements?

Yes, you need to have the `requests`, `mdutils`, and `python-dotenv` packages installed, and you must configure the `LINEAR_API_KEY` in your `.env` file.