clawlink-hq Linear
Use Linear from your AI agent through ClawLink — browser login, no API key to paste, no config to edit. Connect Linear once and the agent can read and act on it. Works in any agent that can run shell commands (Claude Code, Cursor, Codex, Cline, and more).
Setup
Run these once — the agent can run them for you:
npx @useclawlink/cli login # opens browser → approve (mints + stores a key)
npx @useclawlink/cli connect linear # opens browser → authorize Linear
No API key to create or paste — login stores the credential at ~/.clawlink/credentials.json.
Using Linear
npx @useclawlink/cli actions linear "<what you want to do>" # find an action
npx @useclawlink/cli describe linear <action-id> # see its inputs (before writes)
npx @useclawlink/cli run linear <action-id> --input '<json>' # execute
Reads first; confirm with the user before any write.
Available actions
| Action | Description |
|---|---|
linear_create_attachment |
Creates a new attachment and associates it with a specific, existing Linear issue. |
linear_create_comment_reaction |
Tool to add a reaction to an existing Linear comment. Use when you want to programmatically react to a comment on an issue. |
linear_create_linear_comment |
Creates a new comment on a specified Linear issue. This action modifies shared workspace data and is not reversible — confirm the target issue and comment content before executing. |
linear_create_linear_issue |
Creates a new issue in a specified Linear project and team, requiring team_id and title, and allowing optional properties like description, assignee, state, priority, cycle, and due date. All UUID parameters (state_id, assignee_id, cycle_id, label_ids, project_id) must belong to the same team as team_id. The created issue's id is returned in data.id — capture it for use as parent_id in sub-issues or follow-up operations. No template_id field exists; expand templates manually into title and description before calling. |
linear_create_linear_issue_relation |
Create a relationship between two Linear issues using the issueRelationCreate mutation. Use this to establish connections like 'blocks', 'duplicate', or 'related' between issues. |
linear_create_linear_label |
Creates a new label in Linear for a specified team, used to categorize and organize issues. Label names must be unique within each team. If a label with the same name already exists, the existing label will be returned. Both new and existing labels return the same object structure; check the label's createdAt or compare IDs to determine if creation occurred. |
linear_create_linear_project |
Creates a new Linear project with specified name and team associations. |
linear_create_project_milestone |
Tool to create a project milestone in Linear with a name and optional target date and sort order. Use when you need to add milestones to track progress within a project. |
linear_create_project_update |
Tool to create a project status update post for a Linear project. Use when you need to post progress updates, status reports, or announcements for a project. |
linear_delete_linear_issue |
Archives an existing Linear issue by its ID, which is Linear's standard way of deleting issues; the operation is idempotent. Archiving is permanent with no built-in undo — confirm the issue identifier and title with the user before executing, especially in bulk operations. |
linear_get_attachment |
Downloads a specific attachment from a Linear issue; the file_name must include the correct file extension. |
linear_get_current_user |
Gets the currently authenticated user's ID, name, email, and other profile information — this is the account behind the API token, which may be a bot or service account rather than a human user. Use the returned id field (nested under data.viewer) for downstream Linear operations requiring user ID filtering. To search or compare other workspace members, use LINEAR_LIST_LINEAR_USERS instead. |
Notes
- No API key for Linear itself — ClawLink holds the OAuth token; the agent only holds your ClawLink credential.
- Not connected yet, or access expired? Re-run
npx @useclawlink/cli connect linear. - The action list above is a snapshot;
npx @useclawlink/cli actions linearis always current.
Resources
- ClawLink: https://claw-link.dev
- Docs: https://docs.claw-link.dev
- CLI: https://www.npmjs.com/package/@useclawlink/cli
Powered by ClawLink — connect 90+ apps to any AI agent.