Linear GraphQL Adapter for AI Agents

This package furnishes an MCP endpoint specifically engineered to interface with the Linear project management system via its robust GraphQL API. It empowers generative AI assistants to interact programmatically with workflow data.

Core Capabilities

• Facilitates access to the Linear GraphQL endpoint through standardized MCP tool calls.
• Requires authentication using a personal Linear API access token.
• Supports reading and updating metadata for personnel, organizational units, initiatives, and tracked items.
• Enables the instantiation, revision, and annotation of issues.
• Handles the attachment and detachment of descriptive labels.
• Provides functionality for bootstrapping new project containers.
• Includes comprehensive internal documentation for all exposed methods.

Deployment Instructions

Preferred Installation via Smithery

For automated setup within environments like Claude Desktop using Smithery:

bash npx -y @smithery/cli install @emmett.deen/linear-mcp-server --client claude

Direct Configuration

Integrate the following configuration structure into your overarching MCP manifest file:

{ "mcpServers": { "linear_api_bridge": { "command": "npx", "args": ["-y", "@emmett.deen/linear-mcp-server"], "env": { "LINEAR_API_KEY": "[INSERT_YOUR_API_KEY_HERE]" } } } }

Configuration Paths for Various Clients

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude VSCode Plugin: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• GoMCP Utility: ~/.config/gomcp/config.yaml

Source Code Setup (Manual Build)

1. Obtain the source code repository:

   bash git clone https://github.com/yourusername/Linear-MCP-Server.git cd Linear-MCP-Server

2. Install project dependencies:

   bash npm install

3. Compile the TypeScript/Source files:

   bash npm run build

4. Establish an environment file (.env) containing the necessary credential:

   LINEAR_API_KEY=your_linear_api_key_here

5. Initiate the service:

   bash npm start

Available Interfaces

Refer to the TOOLS.md document for a comprehensive catalog of exposed functionality and planned capabilities.

Conceptual Summary

Linear-MCP-Server acts as a translation layer, interpreting AI instructions into valid interactions with the Linear GraphQL endpoint. This enables the AI assistant (e.g., Claude) to perform actions such as:

• Querying records for projects, personnel, teams, and issues.
• Authoring new issues and applying modifications to existing ones.
• Altering the workflow stage of an issue.
• Delegating ownership of tasks to specific team members.
• Appending conversational context or notes to tickets.
• Programmatically defining new project structures.

The implementation prioritizes direct API token authentication over OAuth flows for streamlined setup.

Initializing the Service

Prerequisites

• Runtime Environment: Node.js version 18 or newer.
• Package Manager: NPM or Yarn.
• Authorization Credential: A valid Linear API access token.

Installation Methods

bash

Install globally for system-wide access

npm install -g @emmett.deen/linear-mcp-server

Or, clone and utilize locally

git clone https://github.com/yourusername/Linear-MCP-Server.git cd Linear-MCP-Server npm install npm link # Register locally for global invocation

Executing the Adapter

Invoke the server, supplying the required authentication key:

bash linear-mcp-server --token YOUR_LINEAR_API_TOKEN

Alternatively, configure the environment variable:

bash export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN linear-mcp-server

Integration with Claude Desktop

To link this service with Claude Desktop:

1. Activate Developer Mode within Claude's menu bar.
2. Navigate to Settings > Developer options.
3. Select "Add Server".
4. Configure the parameters:
   • Designation: Linear MCP Adapter
   • Protocol Type: Local Process
   • Execution Command: linear-mcp-server
   • Parameters: --token YOUR_LINEAR_API_TOKEN

Alternatively, modify the configuration file directly:

{ "mcp": { "servers": [ { "name": "Linear MCP Adapter", "transport": { "type": "stdio", "command": "linear-mcp-server", "args": ["--token", "YOUR_LINEAR_API_TOKEN"] } } ] } }

1. Persist the changes.
2. Perform a full restart of the Claude Desktop application.
3. The adapter should now be available for selection in Claude's tool palette.

Illustrative AI Interactions

Once connected, an AI assistant can handle requests such as:

• "List all pending items assigned to me in Linear."
• "Generate a new task: 'Resolve authentication failure' within the 'Infrastructure' vertical."
• "Advance ticket ID FE-123 to the 'In Review' state."
• "Delegate ticket BE-456 ownership to Alice Johnson."
• "Post an update to ticket UI-789: 'Blocker identified; awaiting design review.'"

Development Workflow

For local development and modification:

bash

Clone the repository

git clone https://github.com/yourusername/Linear-MCP-Server.git cd Linear-MCP-Server

Install necessary packages

npm install

Execute in watch/development mode

npm run dev -- --token YOUR_LINEAR_API_TOKEN

Augmenting Server Capabilities

To introduce novel tools to the adapter:

1. Consult the implementation guidelines within TOOLS.md.
2. Adhere strictly to the established architectural patterns located in the src/ directory.
3. Ensure accompanying documentation is updated to reflect the new methods.

Contribution Guidelines

Environment Preparation

1. Clone the repository:

   bash git clone https://github.com/yourusername/Linear-MCP-Server.git cd Linear-MCP-Server

2. Install dependencies:

   bash npm install

3. Start the development server:

   bash npm run dev

Publishing Updates to npm

To release a new version:

1. Increment the version number in package.json:

   bash npm version patch # or minor, or major

2. Rebuild the project assets:

   bash npm run build

3. Verify you are authenticated with npm:

   bash npm login

4. Deploy the package publicly:

   bash npm publish --access public

5. For inclusion in the Smithery registry, coordinate directly with the Smithery support team regarding catalog submission.

Legal Notice

This software is distributed under the terms of the MIT License (refer to the LICENSE file for full details).

== Context on Business Operational Tools == Organizational efficiency systems encompass all methodologies, applications, controls, computational frameworks, and processes utilized by entities to adapt to shifting market dynamics, maintain competitive standing, and elevate overall performance metrics. These systems are highly diversified.

== Functional Segmentation == Tools can be cross-referenced across various organizational divisions based on their operational focus. A functional taxonomy might categorize them by:

Interfaces for data intake and verification across departments. Systems dedicated to monitoring and refining operational workflows. Platforms used for data aggregation and strategic interpretation. Modern business solutions have undergone rapid metamorphosis fueled by technological progress, making the selection of optimal tools for specific corporate contexts increasingly complex. This challenge is driven by continuous pressure to reduce expenditures, maximize revenue, deeply understand client requirements, and deliver products meeting those precise specifications. In this environment, leadership must adopt a strategic viewpoint concerning these management technologies, rather than blindly adopting the newest available product. Over-reliance on unmodified, off-the-shelf solutions often results in organizational instability. Selection of business management tools must be deliberate, followed by necessary tailoring to fit the specific organizational architecture, not the inverse.

== Global Usage Trends (2013 Benchmark) == A 2013 survey conducted by Bain & Company mapped the global utilization patterns of these systems, reflecting how their outputs address regional necessities amidst varied economic climates. Noteworthy categories frequently cited include:

Strategic roadmap formulation Customer relationship management platforms Personnel sentiment analysis Competitive benchmarking practices Integrated performance measurement (e.g., Balanced Scorecard) Identification of core operational strengths External resource allocation (Outsourcing) Organizational transformation initiatives Logistics and distribution network oversight Definition of organizational purpose and vision Customer base delineation Integrated quality control systems

== Business Software Applications Defined == Software or a suite of computer programs employed by enterprise users to execute diverse operational tasks is classified as business software or an enterprise application. These applications serve to amplify output, provide performance measurement capabilities, and execute various organizational functions with precision. The evolution progressed from foundational Management Information Systems (MIS) to comprehensive Enterprise Resource Planning (ERP), subsequently incorporating Customer Relationship Management (CRM), culminating in the current landscape dominated by cloud-based management suites. While a measurable link exists between IT investment and organizational success, two factors are critical multipliers: the efficacy of the implementation process itself and the judicious selection and subsequent customization of the technological assets.