← Back to Skills Marketplace
14218
Downloads
18
Stars
0
Active Installs
7
Versions
Install in OpenClaw
/install linear-api
Description
Linear API integration with managed OAuth. Query and manage issues, projects, teams, cycles, and labels using GraphQL.
Use this skill when users want to create, update, or query Linear issues, search for tasks, manage projects, or track work.
For other third party apps, use the api-gateway skill (ht
Usage Guidance
Install this only if you are comfortable using Maton as a proxy for your Linear account and granting it access through OAuth. Confirm any create, update, delete, or comment action before it runs, and avoid printing MATON_API_KEY in terminals or logs that others can see.
Capability Assessment
Purpose & Capability
The documented capability matches the stated purpose: querying and managing Linear issues, projects, teams, cycles, labels, comments, users, and OAuth connections through Maton and Linear GraphQL.
Instruction Scope
The skill discloses network use, MATON_API_KEY authentication, Maton proxying, OAuth connection management, and create/update/delete-style actions; it explicitly requires user approval before write operations.
Install Mechanism
Installation asks users to install the third-party Maton CLI globally via npm or Homebrew, which is purpose-aligned but should be treated as installing external tooling.
Credentials
The required environment access is limited to MATON_API_KEY and network calls to Maton/Linear endpoints, which is proportionate for this integration; the troubleshooting step that echoes the API key could expose it in shared logs.
Persistence & Privilege
OAuth connections persist through Maton and can affect the connected Linear account, but the skill documents listing, selecting, creating, and deleting those connections and shows no background worker, local indexing, or hidden privilege escalation.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install linear-api - After installation, invoke the skill by name or use
/linear-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.6
- Removed the sample file `skill-card.md`.
- No other user-facing changes or new features.
v1.0.5
- Added Maton CLI commands throughout documentation for improved usability and quick start.
- Expanded setup instructions to include Homebrew and NPM installation options.
- Provided CLI equivalents for all connection management and core API tasks alongside existing Python examples.
- Updated example queries and CLI usage for more practical, real-world tasks (issue listing, team view, etc.).
- Clarified connection specification steps for users with multiple Linear accounts.
v1.0.4
- Updated API and connection management endpoints from `gateway.maton.ai`/`ctrl.maton.ai` to `api.maton.ai`
- Added new section outlining security & permissions, highlighting the need for explicit user approval for write operations
- Improved instructions for specifying which Linear connection to use when working with multiple accounts
- Clarified proxying and authentication flow for Maton API integrations
- Removed the file `LICENSE.txt`
v1.0.3
- Added `clawdbot` metadata section with required environment variable `MATON_API_KEY`.
- No changes to API, documentation, or functionality.
v1.0.2
- Documentation update only: SKILL.md file has been modified.
- No functional changes to the skill; endpoints and usage remain the same.
v1.0.1
- No code or documentation changes detected in this version.
- Version number incremented to 1.0.1.
v1.0.0
Initial release of the Linear API integration skill.
- Provides access to the Linear API with managed OAuth authentication via the Maton platform.
- Allows querying and managing issues, projects, teams, cycles, labels, and comments using GraphQL.
- Includes connection management endpoints (list, create, get, delete) for Linear OAuth connections.
- Offers detailed usage examples for key workflows (issue search, create/update issues, team/project querying).
- Requires a Maton API key and network access for all operations.
Metadata
Frequently Asked Questions
What is Linear?
Linear API integration with managed OAuth. Query and manage issues, projects, teams, cycles, and labels using GraphQL. Use this skill when users want to create, update, or query Linear issues, search for tasks, manage projects, or track work. For other third party apps, use the api-gateway skill (ht. It is an AI Agent Skill for Claude Code / OpenClaw, with 14218 downloads so far.
How do I install Linear?
Run "/install linear-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Linear free?
Yes, Linear is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Linear support?
Linear is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Linear?
It is built and maintained by byungkyu (@byungkyu); the current version is v1.0.6.
More Skills