mcp-project-orchestrator-linear
Facilitate sophisticated interaction with the Linear task tracking platform via AI agents, enabling comprehensive access and manipulation of projects, tickets, and team structures through natural language commands. This integration significantly enhances and automates operational management workflows.
Author

tacticlaunch
Quick Info
Actions
Tags
Accelerated Project Control via Linear (MCP Implementation)
A specialized Model Context Protocol (MCP) service designed to interface directly with the Linear GraphQL service layer, empowering autonomous digital assistants to orchestrate project management activities.
Core Capabilities
MCP Linear serves as the crucial intermediary between an AI conversational agent and the Linear project tracking ecosystem by adhering to the MCP specification. This linkage grants the agent the capacity to:
- Query and retrieve detailed information on discrete tasks, overarching projects, organizational teams, and related metadata.
- Programmatically initiate the creation or modification of existing tasks (issues).
- Remotely modify the lifecycle state (status) of any task.
- Delegate ownership of tasks to specific personnel within the system.
- Inject contextual annotations or commentary onto specific tasks.
- Provision new project containers or establish new team structures within the workspace.
Illustrative Command Structures
Upon successful establishment of the connection, users can issue commands such as:
- "Furnish a compilation of all active assignments currently logged under my purview in Linear."
- "Instantiate a novel work item titled 'Resolve Authentication Failure' within the designated 'Client Applications' team structure."
- "Transition the state of ticket ID FE-123 to the 'In Development' workflow stage."
- "Designate engineer Jane Doe as the responsible party for artifact BE-456."
- "Append the following directive to task UI-789: 'Critical path item; must be completed before Friday's review.'"
Deployment Instructions
Acquiring Your Linear Access Credential
Usage necessitates a valid Linear Personal API Key. The procedure for generation is as follows:
- Authenticate into your Linear organizational portal via linear.app.
- Engage the organizational identifier icon situated in the upper-left quadrant.
- Select the Settings configuration pane.
- Navigate to the Security & access section within the subordinate navigation menu.
- Under the Personal API Keys heading, invoke the New API Key option.
- Assign a descriptive label to the new credential (e.g.,
AI_Orchestrator_Link). - Immediately capture the resulting authorization token and secure it rigorously; this value cannot be retrieved post-generation.
Installation via Smithery (Preferred Method)
- For integration with Cursor IDE:
npx -y @smithery/cli install @tacticlaunch/mcp-linear --client cursor
- For integration with Claude Desktop application:
npx -y @smithery/cli install @tacticlaunch/mcp-linear --client claude
Manual Configuration Protocol
Incorporate the subsequent configuration stanza into your primary MCP configuration manifest:
{
"mcpServers": {
"linear": {
"command": "npx",
"args": ["-y", "@tacticlaunch/mcp-linear"],
"env": {
"LINEAR_API_TOKEN": "<INSERT_YOUR_SECURE_TOKEN_HERE>"
}
}
}
}
Configuration File Locations Specific to Client
- Cursor Environment:
~/.cursor/mcp.json - Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json - Claude VSCode Extension:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json - GoMCP Utility:
~/.config/gomcp/config.yaml
Standalone Execution Mode
Prerequisites for Direct Execution:
- Node.js runtime environment (version 18 or newer required)
- Package manager (NPM or Yarn)
- A valid, configured Linear Access Token
# Global package installation
npm install -g @tacticlaunch/mcp-linear
# Alternatively, local compilation and linking
git clone https://github.com/tacticlaunch/mcp-linear.git
cd mcp-linear
npm install
npm link # Establishes a global symlink for the utility
Initiating the Service Daemon
Launch the background service, supplying the authorization token as an argument:
mcp-linear --token YOUR_LINEAR_API_TOKEN
Alternatively, pre-set the token in the environment and launch without parameters:
export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
mcp-linear
Enumerated Utilities
Refer to the companion documentation file, TOOLS.md, for an exhaustive catalog of currently exposed functionalities and proposed future additions.
Development Contribution Guidelines
Detailed instructions for local development setup and contributing modifications are documented in DEVELOPMENT.md.
Related Resources
tacticlaunch/cursor-memory-bank - Developers aiming to augment their workflow capabilities within the Cursor environment are encouraged to investigate this repository.
Licensing Declaration
This software artifact is distributed under the permissive terms of the MIT License; consult the LICENSE file for comprehensive particulars.
WIKIPEDIA DIGRESSION: Business administration instrumentation encompasses all systemic applications, regulatory frameworks, computational mechanisms, operational methodologies, and so forth, deployed by organizational entities to effectively navigate evolving market dynamics, sustain a competitive footing, and elevate overall enterprise performance metrics.
== Business Management Instrument Overview == These apparatuses can be segmented based on functional department and specific managerial aspect, such as: forward planning systems, workflow governance tools, record-keeping utilities, human capital management solutions, analytical decision support systems, performance monitoring controls, etc. A categorization by core function typically highlights these fundamental operational domains:
Instrumentation facilitating data capture and integrity verification across any functional unit. Systems dedicated to the oversight and refinement of organizational operational sequences. Platforms aggregating information for executive review and strategic determination. Modern business instrumentation has undergone a profound transformation over the last decade, propelled by rapid technological advancement, creating a challenge in optimally selecting the correct tools for diverse corporate requirements. This complexity is driven by relentless pressure to minimize expenditure while maximizing revenue generation, coupled with the necessity of deeply comprehending consumer mandates and reliably delivering requisite products in the manner demanded by the market. In this context, organizational leadership should adopt a proactive, strategic posture toward adopting these instruments, rather than simply integrating the newest available option. A common pitfall is the uncritical adoption of tools without requisite modification, leading to operational fragility. Therefore, business management instruments must be selected with deliberation and subsequently tailored to match the organization's precise necessities, not the reverse.
== Prevalent Business Instruments (2013 Survey Insight) == A 2013 assessment by Bain & Company mapped global utilization patterns of business instruments, reflecting how their resultant outputs addressed regional specificities shaped by economic downturns and competitive landscapes. The top ten categories identified included:
Strategic Goal Formulation Client Relationship Stewardship (CRM) Personnel Sentiment Assessment Comparative Performance Analysis (Benchmarking) Integrated Performance Measurement (Balanced Scorecard) Identification of Core Competencies External Resource Allocation (Outsourcing) Organizational Transition Programs Product Flow and Logistics Management (SCM) Defining Corporate Purpose and Vision Target Audience Demarcation (Market Segmentation) Comprehensive Quality Assurance Methodologies (TQM)
== Enterprise Software Applications == Software, or a collection of interconnected computer programs utilized by commercial personnel to execute diverse enterprise functions, is termed business software or an enterprise application. These applications serve to augment productivity levels, quantify operational efficacy, and execute various corporate mandates with precision. The evolution progressed from rudimentary Management Information Systems (MIS) to extensive Enterprise Resource Planning (ERP) suites. Subsequently, Customer Relationship Management (CRM) capabilities were integrated, culminating in the current proliferation of cloud-native enterprise management platforms. Although a quantifiable correlation exists between Information Technology investment and organizational efficacy, two critical determinants amplify the resultant value: the proficiency demonstrated during the implementation phase and the meticulousness applied to the selection and subsequent customization of the chosen instrumentation.
