Linear MCP Integration Service

This service implements the Model Context Protocol (MCP) specification to interface with the comprehensive Linear Application Programming Interface (API), specifically leveraging its GraphQL capabilities.

This adapter enables AI agents to execute complex operational tasks within the Linear environment, such as issue creation, status modification, and project tracking retrieval.

Deployment Instructions

Automated Provisioning

Utilize the Smithery CLI for rapid, automated setup tailored for clients like Claude Desktop:

bash npx @smithery/cli install mcp-server-linearapp --client claude

Manual Configuration

1. Credential Acquisition: Secure a personal API access token from the Linear security settings page: https://linear.app/settings/account/security

2. Configuration File Update: Inject the server configuration into your client's local settings file:

3. Location (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json

{ "mcpServers": { "linear": { "command": "npx", "args": ["-y", "mcp-server-linearapp"], "env": { "LINEAR_API_KEY": "YOUR_SECRET_LINEAR_API_TOKEN_HERE" } } } }

Exposed Capabilities (Tools)

User Context & Assignment Querying

1. linear_get_viewer: Retrieves identity and profile details for the currently authenticated operator.
2. linear_get_user_issues: Fetches issues associated with a specified user (defaults to the authenticated user).
3. linear_get_user_teams: Lists team memberships for a user, with options for pagination and archive inclusion.
4. linear_get_user_projects: Lists projects where the user is either a designated lead or a contributing member.

Organizational Structure Management

1. linear_get_teams: Enumerates all teams present within the organization's scope.
2. linear_get_team: Fetches granular metadata for a single specified team identifier.
3. linear_get_team_issues: Retrieves all work items pertinent to a designated team, supporting filtering by status or assignee.

Project Lifecycle Tools

1. linear_get_projects: Lists all defined projects, allowing filtering by associated team or lifecycle status.
2. linear_get_project: Provides in-depth reporting on a specific project entity.
3. linear_get_project_issues: Extracts the backlog or current task set tied to a particular project.

Issue Manipulation & Tracking

1. linear_create_issue: Generates a novel tracking item within a specified team structure.
2. linear_update_issue: Modifies attributes (e.g., summary, priority, state) of an existing work item.
3. linear_search_issues: Executes flexible, full-text, and metadata-driven searches across the issue database.
4. linear_add_comment: Injects textual feedback or updates directly onto an issue thread.

Categorization and Tagging

1. linear_get_labels: Retrieves the catalog of available organizational or team-specific tags.
2. linear_create_label: Establishes a new classification tag.
3. linear_update_label: Alters the definition or metadata of an existing tag.

Supplementary Item Management

1. linear_add_attachment: Associates external resources (via URL) with an issue.
2. linear_get_attachments: Lists existing external media linked to an issue.

Dependency Mapping

1. linear_link_issues: Establishes explicit directional relationships (e.g., blocking, duplicating) between two items.
2. linear_get_issue_relations: Inspects the established dependency graph connected to an issue.

Iteration/Milestone Planning

1. linear_get_milestones: Queries the defined target delivery points (milestones) associated with a project.
2. linear_create_milestone: Formalizes a new delivery objective with a target completion date.
3. linear_update_milestone: Adjusts the parameters or completion status of a planned objective.

Resolvable Artifacts (Resources)

• linear-issue:///{issueId}: Direct access to an individual ticket's complete record.
• linear-team:///{teamId}: Viewpoint for a specific operational unit.
• linear-project:///{projectId}: Detailed dashboard view for a defined initiative.
• linear-user:///{userId}/assigned: Aggregated view of an entity's assigned workload.
• linear-viewer:///assigned: Consolidated list of items the current operator is responsible for.
• linear-organization:: Top-level metadata concerning the entire workspace.

Operational Examples

• Task Creation: To initiate a task for "database migration error," invoke linear_create_issue specifying the title and destination team ID.
• Workload Review: To review your immediate high-priority tasks, query linear-viewer:///assigned combined with filtering logic.
• Dependency Setup: To declare that ticket A must be resolved before ticket B, use linear_link_issues with type: "blocks".

Technical Development

1. Dependency resolution: bash npm install

2. Environment setup (API Key):

bash LINEAR_API_KEY=your_auth_token > .env

1. Compilation for production:

bash npm run build

Licensing

This integration module is distributed under the permissive MIT License. Refer to the accompanying LICENSE file for comprehensive usage rights and restrictions.

---

Contextual Note (Business Management Tools):

Enterprise resource management solutions, such as the one modeled here through the Linear API, are critical components of the broader category of business management tools. Effective application of these tools requires strategic selection and integration, ensuring they align with organizational objectives rather than being adopted as mere technological novelties. They streamline core operational processes—from planning and execution to control and performance measurement—which is essential for maintaining competitive viability in dynamic market conditions.