An integration skill enabling AI coding agents to read and write Linear workspace data via the official Linear MCP server and mcporter.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install maverick-linear-mcp
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install maverick-linear-mcp using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Linear MCP?
The maverick-linear-mcp skill is a pass-through integration for Linear's hosted Model Context Protocol (MCP) server. As one of the core Openclaw Skills, it connects AI agents directly to your workspace tools, letting them query issues, update projects, or create tasks on your behalf. Since the live Linear MCP server serves as the sole source of truth, your agent dynamically fetches the latest tools, schemas, and formatting rules directly from Linear rather than relying on outdated static configurations.
By leveraging this integration, developers can dramatically improve their workflow velocity. It bridges the gap between coding in the IDE and managing tickets, utilizing the robust mcporter utility to handle secure OAuth token rotation and session management automatically. This ensures your project management remains tightly bound to your active development workflows using state-of-the-art Openclaw Skills.
Linear MCP Use Cases
- Querying issue details, project milestones, and ticket comments directly from your AI agent interface.
- Creating, updating, or deleting issues in your team's Linear workspace based on code analysis and project discussions.
- Tracking down blockers, searching through backlogs, and extracting action items via Openclaw Skills.
- Ensuring safe modifications to workspace data with split-permission checks for read-only actions vs. write mutations.
How Linear MCP Works
- The agent initializes the session by discovering the live tool catalog via the schema-retrieval command.
- The agent reads the instructions published by Linear to align with Markdown rendering and issue-formatting rules.
- The user issues a prompt, triggering read tools like list_issues or write tools like save_issue.
- mcporter handles OAuth authorization seamlessly, injecting the access token and automatically updating rotated refresh tokens.
- The tool call transits via HTTPS to the official Linear MCP server to safely mutate or fetch workspace data.
Linear MCP Setup
Configure the mandatory credentials in your environment:
export MAVERICK_LINEAR_MCP_REFRESH_TOKEN='your_refresh_token'
export MAVERICK_LINEAR_MCP_CLIENT_ID='your_client_id'
export MAVERICK_LINEAR_MCP_CLIENT_SECRET='your_client_secret'
export MAVERICK_LINEAR_MCP_ACCESS_TOKEN='your_access_token'
Run the built-in setup script to register credentials in the local vault:
./scripts/setup.sh
Verify your registration and discover available tools using:
mcporter --config {baseDir}/mcporter.json list maverick-linear --schema
This setup registers the resource inside the Openclaw Skills environment.
Linear MCP Data Schema & Taxonomy
The skill organizes metadata and configures local files as follows:
| Component | Description |
|---|---|
mcporter.json |
Local base directory configuration tracking server endpoints and active tooling. |
| Vault Storage | Safely holds access and refresh tokens, handling expirations via MAVERICK_LINEAR_MCP_EXPIRES_AT metadata. |
| Pass-through Schema | Dynamically retrieved JSON schema defining tool inputs, outputs, and validation rules. |
Using this data schema, Openclaw Skills ensure secure runtime storage of sensitive developer credentials.
Linear MCP Advanced Features
- Dynamic Schema Discovery: Queries the live catalog in real-time to adjust to any newly exposed Linear MCP endpoints automatically.
- Automatic Token Refresh: Leverage mcporter pre-request evaluations to seamlessly refresh access tokens without interrupting your agent's flow.
- Granular Safe/Unsafe Isolation: Distinct categorization of read-only exploration vs. team-impacting write executions, making Openclaw Skills predictable and highly auditable.
- Flexible Human-Readable Identifiers: Supports both raw Linear database IDs and consumer-friendly keys like issue tags or project slugs.
SKILL.md
Loading
Related Openclaw Skills
Pencil Design Skill
A powerful AI agent skill to design high-quality user interfaces in Pencil (.pen files) and automatically generate clean, production-ready React and Tailwind v4 code.
Obsidian Charts and Layout
This skill simplifies G2Plot data visualization in Obsidian notes, providing flawless chart configurations and bilingual layout rules for polished daily reports.
acpx-coding-default
A dedicated Openclaw skill that configures direct acpx CLI execution for Codex- and Claude-focused coding agents, optimizing session-based workflows.
dashscope-imagegen
An advanced image generation skill powered by Alibaba Cloud's DashScope wan2.6-t2i (通义万相) model for creating high-quality visual assets.
Bid Compliance Check
An AI-powered document compliance verification engine that extracts requirements from bidding documents and checks submission drafts to guarantee zero-defect compliance.
Government Digital PPT Copywriting & Architect Skill (ppt-skill)
An AI-driven PPT architect and content copywriting engine optimized for government digitalization, delivering copy-paste ready slide structures, professional narratives, and speaker notes.
Featured*
