linear

Name: linear
Author: AlexAI-MCP

132stars24forks

How to install linear?

alexai-mcp/hermes-ccc/linear

$npx -y skills add AlexAI-MCP/hermes-CCC --skill linear

Installs into the current project.

Summary

Linear project management — create issues, manage cycles, update projects, and query team progress via Linear API or MCP.

Files · 1

View on GitHub

SKILL.md

1	# Linear Project Management
2
3	Manage Linear issues, cycles, projects, and team workflows via the Linear API (GraphQL) or MCP.
4
5	## Setup
6
7	```bash
8	# Get API key from Linear: Settings → API → Personal API Keys
9	export LINEAR_API_KEY="lin_api_..."
10	```
11
12	```python
13	import requests
14
15	LINEAR_API = "https://api.linear.app/graphql"
16	HEADERS = {
17	"Authorization": f"Bearer {LINEAR_API_KEY}",
18	"Content-Type": "application/json"
19	}
20
21	def linear_query(query, variables=None):
22	resp = requests.post(LINEAR_API, json={"query": query, "variables": variables or {}}, headers=HEADERS)
23	return resp.json()["data"]
24	```
25
26	---
27
28	## List Issues
29
30	```python
31	query = """
32	query {
33	issues(filter: {assignee: {isMe: {eq: true}}, state: {type: {nin: ["completed", "cancelled"]}}}) {
34	nodes {
35	id title priority state { name } team { name }
36	}
37	}
38	}
39	"""
40	data = linear_query(query)
41	for issue in data["issues"]["nodes"]:
42	print(f"[{issue['state']['name']}] {issue['title']}")
43	```
44
45	---
46
47	## Create Issue
48
49	```python
50	mutation = """
51	mutation CreateIssue($title: String!, $teamId: String!, $description: String, $priority: Int) {
52	issueCreate(input: {
53	title: $title
54	teamId: $teamId
55	description: $description
56	priority: $priority
57	}) {
58	success
59	issue { id title url }
60	}
61	}
62	"""
63
64	data = linear_query(mutation, {
65	"title": "Fix auth bug in production",
66	"teamId": "TEAM_ID",
67	"description": "Users getting 401 on refresh token",
68	"priority": 1 # 0=no priority, 1=urgent, 2=high, 3=medium, 4=low
69	})
70	print(data["issueCreate"]["issue"]["url"])
71	```
72
73	---
74
75	## Get Teams
76
77	```python
78	teams_query = """
79	query { teams { nodes { id name key } } }
80	"""
81	data = linear_query(teams_query)
82	for team in data["teams"]["nodes"]:
83	print(f"{team['key']}: {team['name']} ({team['id']})")
84	```
85
86	---
87
88	## Update Issue
89
90	```python
91	update_mutation = """
92	mutation UpdateIssue($id: String!, $stateId: String) {
93	issueUpdate(id: $id, input: { stateId: $stateId }) {
94	success
95	}
96	}
97	"""
98	linear_query(update_mutation, {"id": "ISSUE_ID", "stateId": "STATE_ID"})
99	```
100
101	---
102
103	## Search Issues
104
105	```python
106	search_query = """
107	query SearchIssues($query: String!) {
108	issueSearch(query: $query) {
109	nodes { id title state { name } url }
110	}
111	}
112	"""
113	data = linear_query(search_query, {"query": "auth bug"})
114	```
115
116	---
117
118	## Cycles (Sprints)
119
120	```python
121	cycles_query = """
122	query {
123	cycles(filter: {isActive: {eq: true}}) {
124	nodes {
125	id name number startsAt endsAt
126	issues { nodes { id title state { name } } }
127	}
128	}
129	}
130	"""
131	data = linear_query(cycles_query)
132	```
133
134	---
135
136	## MCP Integration
137
138	If Linear MCP is installed in `.mcp.json`:
139	```json
140	{
141	"mcpServers": {
142	"linear": {
143	"command": "npx",
144	"args": ["-y", "@modelcontextprotocol/server-linear"],
145	"env": {"LINEAR_API_KEY": "lin_api_..."}
146	}
147	}
148	}
149	```
150
151	Then Claude can use Linear tools directly without GraphQL code.
152
153	---
154
155	## Webhooks (receive events)
156
157	```python
158	# Linear sends POST to your endpoint on issue create/update
159	# Payload includes: type, action, data.issue
160	# Verify with: X-Linear-Signature header
161	import hmac, hashlib
162
163	def verify_signature(payload, signature, secret):
164	expected = hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()
165	return hmac.compare_digest(f"sha256={expected}", signature)
166	```

People who liked this also viewed

6 picks

Type

lark-drive飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sSkillsJul 2026382k16k
lark-sharedUse for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handlingSkillsJul 2026382k16k
lark-whiteboard飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责：飞书云文档内容编辑（lark-doc）、文档内嵌电子表格/Base（lark-sheets / lark-base）。SkillsJul 2026380k16k
lark-task飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册注销任务智能体、更新智能体主页数据、写入任务记录时使用。SkillsJul 2026380k16k
lark-attendance飞书考勤打卡：查询自己的考勤打卡记录SkillsJul 2026330k16k
lark-apps妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用角色与成员管理、自动化触发器（定时/记录变更/Webhook/飞书审批）。当用户要SkillsJul 2026227k16k

linear

132stars24forks

View on GitHub

How to install linear?

alexai-mcp/hermes-ccc/linear

$npx -y skills add AlexAI-MCP/hermes-CCC --skill linear

Installs into the current project.

Summary

Linear project management — create issues, manage cycles, update projects, and query team progress via Linear API or MCP.

Files · 1

View on GitHub

SKILL.md

1	# Linear Project Management
2
3	Manage Linear issues, cycles, projects, and team workflows via the Linear API (GraphQL) or MCP.
4
5	## Setup
6
7	```bash
8	# Get API key from Linear: Settings → API → Personal API Keys
9	export LINEAR_API_KEY="lin_api_..."
10	```
11
12	```python
13	import requests
14
15	LINEAR_API = "https://api.linear.app/graphql"
16	HEADERS = {
17	"Authorization": f"Bearer {LINEAR_API_KEY}",
18	"Content-Type": "application/json"
19	}
20
21	def linear_query(query, variables=None):
22	resp = requests.post(LINEAR_API, json={"query": query, "variables": variables or {}}, headers=HEADERS)
23	return resp.json()["data"]
24	```
25
26	---
27
28	## List Issues
29
30	```python
31	query = """
32	query {
33	issues(filter: {assignee: {isMe: {eq: true}}, state: {type: {nin: ["completed", "cancelled"]}}}) {
34	nodes {
35	id title priority state { name } team { name }
36	}
37	}
38	}
39	"""
40	data = linear_query(query)
41	for issue in data["issues"]["nodes"]:
42	print(f"[{issue['state']['name']}] {issue['title']}")
43	```
44
45	---
46
47	## Create Issue
48
49	```python
50	mutation = """
51	mutation CreateIssue($title: String!, $teamId: String!, $description: String, $priority: Int) {
52	issueCreate(input: {
53	title: $title
54	teamId: $teamId
55	description: $description
56	priority: $priority
57	}) {
58	success
59	issue { id title url }
60	}
61	}
62	"""
63
64	data = linear_query(mutation, {
65	"title": "Fix auth bug in production",
66	"teamId": "TEAM_ID",
67	"description": "Users getting 401 on refresh token",
68	"priority": 1 # 0=no priority, 1=urgent, 2=high, 3=medium, 4=low
69	})
70	print(data["issueCreate"]["issue"]["url"])
71	```
72
73	---
74
75	## Get Teams
76
77	```python
78	teams_query = """
79	query { teams { nodes { id name key } } }
80	"""
81	data = linear_query(teams_query)
82	for team in data["teams"]["nodes"]:
83	print(f"{team['key']}: {team['name']} ({team['id']})")
84	```
85
86	---
87
88	## Update Issue
89
90	```python
91	update_mutation = """
92	mutation UpdateIssue($id: String!, $stateId: String) {
93	issueUpdate(id: $id, input: { stateId: $stateId }) {
94	success
95	}
96	}
97	"""
98	linear_query(update_mutation, {"id": "ISSUE_ID", "stateId": "STATE_ID"})
99	```
100
101	---
102
103	## Search Issues
104
105	```python
106	search_query = """
107	query SearchIssues($query: String!) {
108	issueSearch(query: $query) {
109	nodes { id title state { name } url }
110	}
111	}
112	"""
113	data = linear_query(search_query, {"query": "auth bug"})
114	```
115
116	---
117
118	## Cycles (Sprints)
119
120	```python
121	cycles_query = """
122	query {
123	cycles(filter: {isActive: {eq: true}}) {
124	nodes {
125	id name number startsAt endsAt
126	issues { nodes { id title state { name } } }
127	}
128	}
129	}
130	"""
131	data = linear_query(cycles_query)
132	```
133
134	---
135
136	## MCP Integration
137
138	If Linear MCP is installed in `.mcp.json`:
139	```json
140	{
141	"mcpServers": {
142	"linear": {
143	"command": "npx",
144	"args": ["-y", "@modelcontextprotocol/server-linear"],
145	"env": {"LINEAR_API_KEY": "lin_api_..."}
146	}
147	}
148	}
149	```
150
151	Then Claude can use Linear tools directly without GraphQL code.
152
153	---
154
155	## Webhooks (receive events)
156
157	```python
158	# Linear sends POST to your endpoint on issue create/update
159	# Payload includes: type, action, data.issue
160	# Verify with: X-Linear-Signature header
161	import hmac, hashlib
162
163	def verify_signature(payload, signature, secret):
164	expected = hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()
165	return hmac.compare_digest(f"sha256={expected}", signature)
166	```

People who liked this also viewed

6 picks

Type