Skip to main content
Glama

Linear MCP by usefulapi

by io.usefulapi
OverviewDiscussionsAdmin

Server Details

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

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
80.7% over 54 days
Last Tested
Transport
Streamable HTTP · MCP 2025-06-18
URL
Repository
m190/usefulapi-mcp
GitHub Stars
0

TDQS

A3.9/5.0

Scored across 8 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: adding comments, creating issues, fetching by ID, listing cycles/projects/teams, viewing assigned issues, and searching. No ambiguity between them.

Naming Consistency4/5

All tools follow a 'linear_' prefix with verb_noun pattern (e.g., linear_create_issue, linear_list_teams). The exception is 'linear_my_issues' which is not strictly verb_noun but still intuitive.

Tool Count5/5

With 8 tools, the set is well-scoped for a project management integration. It covers core operations without being overwhelming or sparse.

Completeness3/5

Covers basic CRUD for issues (create, get, comment) and listing of projects/cycles/teams, but missing update_issue and delete_issue, which are notable gaps for a complete workflow.

Available Tools

8 tools
linear_add_commentAdd comment (WRITE — mutates Linear)Inspect

⚠️ WRITE / MUTATING: posts a comment on an issue. Requires the issueId (UUID) and a markdown body. GraphQL: mutation commentCreate.

ParametersJSON Schema
NameRequiredDescriptionDefault
bodyYesComment text in markdown.
issueIdYesUUID of the issue to comment on (the `id` field, not the ENG-123 identifier).
linear_create_issueCreate issue (WRITE — mutates Linear)Inspect

⚠️ 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.

ParametersJSON Schema
NameRequiredDescriptionDefault
titleYesIssue title.
teamIdYesUUID of the team to create the issue in (from linear_list_teams).
priorityNo0 none, 1 urgent, 2 high, 3 medium, 4 low.
assigneeIdNoUUID of the user to assign the issue to.
descriptionNoIssue body in markdown.
linear_get_issueGet one issue
Read-only
Inspect

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).

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesIssue UUID or identifier like "ENG-123".
linear_list_cyclesList cycles
Read-only
Inspect

List cycles (sprints), optionally scoped to a team by key, with number, name and start/end dates. Read-only. GraphQL: query cycles(filter).

ParametersJSON Schema
NameRequiredDescriptionDefault
firstNoMax cycles to return. Default 25.
teamKeyNoTeam key, e.g. "ENG", to scope cycles to one team.
linear_list_projectsList projects
Read-only
Inspect

List projects in the workspace (id, name, state, progress, target date). Read-only. GraphQL: query projects.

ParametersJSON Schema
NameRequiredDescriptionDefault
firstNoMax projects to return. Default 50.
linear_list_teamsList teams
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
firstNoMax teams to return. Default 50.
linear_my_issuesMy assigned issues
Read-only
Inspect

List issues assigned to the current user (the API key's owner / OAuth actor) via viewer.assignedIssues. Read-only. GraphQL: query viewer { assignedIssues }.

ParametersJSON Schema
NameRequiredDescriptionDefault
firstNoMax issues to return. Default 25.
linear_search_issuesSearch / filter issues
Read-only
Inspect

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).

ParametersJSON Schema
NameRequiredDescriptionDefault
firstNoMax issues to return. Default 25.
queryNoFree text to match against issue titles (containsIgnoreCase).
stateNoWorkflow-state name, e.g. "In Progress", "Todo", "Done".
teamKeyNoTeam key, e.g. "ENG". Filters to that team.
assigneeEmailNoFilter to issues assigned to this user email.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 8 tool updates
    • Changedlinear_add_comment1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedlinear_create_issue1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedlinear_get_issue1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedlinear_list_cycles1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedlinear_list_projects1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedlinear_list_teams1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedlinear_my_issues1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • Changedlinear_search_issues1 field changed
      • changedInput schema / $schema
        Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
  2. 8 tool updates
    • First observedlinear_add_comment
    • First observedlinear_create_issue
    • First observedlinear_get_issue
    • First observedlinear_list_cycles
    • First observedlinear_list_projects
    • First observedlinear_list_teams
    • First observedlinear_my_issues
    • First observedlinear_search_issues

Related MCP Connectors

Related MCP Servers

  • mcp-linear

    pius-grainger
    F
    license
    A
    quality
    B
    maintenance
    Enables reading and managing Linear issues by human-readable ID, with tools for searching, creating, updating, commenting, and resolving teams, states, labels, and assignees by name.
    11
    -

  • linear

    pipeworx-io
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to interact with Linear workspaces by listing, retrieving, creating, and searching issues, and listing teams via the Linear GraphQL API.
    56 npm
    MIT

  • Linear MCP Server

    timottowitz
    A
    license
    B
    quality
    D
    maintenance
    Enables interaction with Linear's API to manage issues, projects, and teams. Supports creating, updating, searching, and deleting issues, along with project management and team operations through API key authentication.
    13
    249 npm
    MIT
Try in Browser
Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources