MCP server

Linear MCP by usefulapi

io.usefulapi/linear

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Search, read and create Linear issues, projects, teams and cycles.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

8

Token cost

About 1,244 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http linear https://linear.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.linear]
url = "https://linear.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"linear":{"httpUrl":"https://linear.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"linear":{"url":"https://linear.usefulapi.io/mcp"}}}

VS Code

{"servers":{"linear":{"type":"http","url":"https://linear.usefulapi.io/mcp"}}}

Antigravity

agy mcp add linear https://linear.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"linear","server_url":"https://linear.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"linear","server_url":"https://linear.usefulapi.io/mcp"}

Tools

• linear_add_comment Sends messages · ~148 tokens
  ⚠️ WRITE / MUTATING: posts a comment on an issue. Requires the issueId (UUID) and a markdown body. GraphQL: mutation commentCreate.
• linear_create_issue ~249 tokens
  ⚠️ WRITE / MUTATING: creates a new issue in Linear. Requires a teamId (from linear_list_teams) and a title. Optional description (markdown), priority (0=none,1=urgent,2=high,3=medium,4=low), and assigneeId. GraphQL: mutation issueCreate.
• linear_get_issue ~120 tokens
  Fetch a single issue by its UUID or human identifier (e.g. "ENG-123"), including description, state, assignee and recent comments. Read-only. GraphQL: query issue(id).
• linear_list_cycles ~143 tokens
  List cycles (sprints), optionally scoped to a team by key, with number, name and start/end dates. Read-only. GraphQL: query cycles(filter).
• linear_list_projects ~108 tokens
  List projects in the workspace (id, name, state, progress, target date). Read-only. GraphQL: query projects.
• linear_list_teams ~120 tokens
  List the teams in the workspace (id, key, name). Use a team's id for linear_create_issue or its key for linear_search_issues. Read-only. GraphQL: query teams.
• linear_my_issues ~120 tokens
  List issues assigned to the current user (the API key's owner / OAuth actor) via viewer.assignedIssues. Read-only. GraphQL: query viewer { assignedIssues }.
• linear_search_issues ~236 tokens
  Find issues, optionally filtered by a text query (matches title), team key, workflow-state name, or assignee email. Read-only. GraphQL: query issues(filter, first).

Browse

• Converting to Markdown
• Email
• Project management

Related MCP servers

• Linear
  Linear MCP — wraps the Linear GraphQL API (OAuth)
• SHIP
  Assign Linear, Jira or GitHub issues to an AI coding agent team that plans, builds, reviews, tests.
• Fieldwire MCP by usefulapi
  Read Fieldwire projects, tasks, plans, forms, RFIs and submittals; create and update tasks.
• ACC MCP
  Autodesk Construction Cloud via APS — projects, issues, RFIs, documents, submittals.
• Kaiku
  Issue tracker and wiki for teams and their agents: find, file and update issues, write pages.
• Soundcheck Live Event Quotes
  Price any live event: parties, weddings, conferences, concerts. Instant estimates, no login.
• Openhook
  Webhook, email and DNS inboxes for AI agents to capture callbacks and test integrations.
• FieldPulse MCP by usefulapi
  Read FieldPulse customers, jobs, estimates, invoices, assets and projects; create and update jobs.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/linear.svg)](https://aptlynx.net/servers/io.usefulapi/linear)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents