{"_id":"@azzerotec/mcp-linear","_rev":"2-43d9fc24a1cdf7d747e1bcf860843385","name":"@azzerotec/mcp-linear","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.9":{"name":"@azzerotec/mcp-linear","version":"1.0.9","keywords":["mcp","linear","cursor","claude","ai","model-context-protocol","project-management","smithery"],"author":{"name":"Alexey Elizarov","email":"alex.elizarov1@gmail.com"},"license":"MIT","_id":"@azzerotec/mcp-linear@1.0.9","maintainers":[{"name":"azzerotec","email":"bruno.azzi@azzero.com.br"}],"homepage":"https://github.com/azzerotec/mcp-linear#readme","bugs":{"url":"https://github.com/azzerotec/mcp-linear/issues"},"bin":{"mcp-linear":"dist/index.js"},"dist":{"shasum":"6d8b8844ec3e71b6c15b379a34e0e7d6f52717b5","tarball":"https://registry.npmjs.org/@azzerotec/mcp-linear/-/mcp-linear-1.0.9.tgz","fileCount":60,"integrity":"sha512-M4AMoCuaqSkpe4jZOnR+BUeqVIbi3pr2v7dG2FCgcGCf94Vo/tDx7oOaaRStQ9N+5FvsYeyTAWfKSKFpHskcWQ==","signatures":[{"sig":"MEUCIGpIuohfQ0qayvCYvD7EkWGuStcc5NrHAKd3tuotLfFaAiEAyp67LgaL1ijD47AWdOKY9xofpNsomJGNj93vVg5U2mM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":979086},"main":"dist/index.js","type":"module","engines":{"node":">=20.0.0"},"gitHead":"0955890f8d7aaf00bc396fab171b1f371252a00b","scripts":{"dev":"nodemon --exec node --loader ts-node/esm src/index.ts","lint":"eslint . --ext .ts","test":"jest --passWithNoTests","build":"tsc","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","inspect":"npx @modelcontextprotocol/inspector node dist/index.js","prepare":"npm run build","test:watch":"jest --watch","postinstall":"node -e \"try { require('fs').chmodSync('./dist/index.js', '755') } catch (e) {}\""},"_npmUser":{"name":"azzerotec","email":"bruno.azzi@azzero.com.br"},"smithery":{"name":"linear","tools":["linear_getViewer","linear_getOrganization","linear_getUsers","linear_getLabels","linear_getTeams","linear_getProjects","linear_createProject","linear_getIssues","linear_getIssueById","linear_searchIssues","linear_createIssue","linear_updateIssue","linear_createComment","linear_addIssueLabel","linear_removeIssueLabel"],"description":"Interact with Linear project management through AI assistants","displayName":"Linear"},"repository":{"url":"git+https://github.com/azzerotec/mcp-linear.git","type":"git"},"_npmVersion":"10.2.4","description":"A Model Context Protocol (MCP) server implementation for the Linear GraphQL API that enables AI assistants to interact with Linear project management systems.","directories":{"doc":"docs"},"_nodeVersion":"21.4.0","dependencies":{"zod":"^3.24.2","cors":"^2.8.5","yargs":"^17.7.2","dotenv":"^16.4.7","helmet":"^8.0.0","express":"^4.21.2","graphql":"^16.10.0","@linear/sdk":"^38.0.0","@types/cors":"^2.8.17","@types/express":"^5.0.0","graphql-request":"^7.1.2","@modelcontextprotocol/sdk":"^1.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","eslint":"^9.21.0","nodemon":"^3.1.9","ts-jest":"^29.2.6","ts-node":"^10.9.2","prettier":"^3.5.2","typescript":"^5.7.3","@types/jest":"^29.5.14","@types/node":"^22.13.5","@types/yargs":"^17.0.33","eslint-config-prettier":"^10.0.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-linear_1.0.9_1745765793886_0.4200679886744405","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@azzerotec/mcp-linear","version":"1.1.0","description":"A Model Context Protocol (MCP) server implementation for the Linear GraphQL API that enables AI assistants to interact with Linear project management systems.","main":"dist/index.js","type":"module","bin":{"mcp-linear":"dist/index.js"},"directories":{"doc":"docs"},"scripts":{"start":"node dist/index.js","inspect":"npx @modelcontextprotocol/inspector node dist/index.js","dev":"nodemon --exec node --loader ts-node/esm src/index.ts","build":"tsc","lint":"eslint . --ext .ts","format":"prettier --write \"src/**/*.ts\"","test":"jest --passWithNoTests","test:watch":"jest --watch","prepare":"npm run build","postinstall":"node -e \"try { require('fs').chmodSync('./dist/index.js', '755') } catch (e) {}\""},"smithery":{"name":"linear","displayName":"Linear","description":"Interact with Linear project management through AI assistants","tools":["linear_getViewer","linear_getOrganization","linear_getUsers","linear_getLabels","linear_getTeams","linear_getProjects","linear_createProject","linear_getIssues","linear_getIssueById","linear_searchIssues","linear_createIssue","linear_updateIssue","linear_createComment","linear_addIssueLabel","linear_removeIssueLabel"]},"keywords":["mcp","linear","cursor","claude","ai","model-context-protocol","project-management","smithery"],"author":{"name":"Alexey Elizarov","email":"alex.elizarov1@gmail.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/azzerotec/mcp-linear.git"},"dependencies":{"@linear/sdk":"^39.1.1","@modelcontextprotocol/sdk":"^1.6.0","@types/cors":"^2.8.17","@types/express":"^5.0.0","cors":"^2.8.5","dotenv":"^16.4.7","express":"^4.21.2","graphql":"^16.10.0","graphql-request":"^7.1.2","helmet":"^8.0.0","yargs":"^17.7.2","zod":"^3.24.2"},"devDependencies":{"@types/jest":"^29.5.14","@types/node":"^22.13.5","@types/yargs":"^17.0.33","eslint":"^9.21.0","eslint-config-prettier":"^10.0.2","jest":"^29.7.0","nodemon":"^3.1.9","prettier":"^3.5.2","ts-jest":"^29.2.6","ts-node":"^10.9.2","typescript":"^5.7.3"},"engines":{"node":">=20.0.0"},"publishConfig":{"access":"public"},"_id":"@azzerotec/mcp-linear@1.1.0","gitHead":"830259e004cb528ca007cc27f30d9d2dd4d57dbf","bugs":{"url":"https://github.com/azzerotec/mcp-linear/issues"},"homepage":"https://github.com/azzerotec/mcp-linear#readme","_nodeVersion":"21.4.0","_npmVersion":"10.2.4","dist":{"integrity":"sha512-oHpFZqOXmHCfqV2CrJcx7HX+AVrwCyb6fMWDq+lfrFyUe0E/CIpJubSFvravh82Xr7lrn7D1v4DkRf6IS7ft4g==","shasum":"9e1f017a8e21e27f70816142a4bab6a5b79777c0","tarball":"https://registry.npmjs.org/@azzerotec/mcp-linear/-/mcp-linear-1.1.0.tgz","fileCount":61,"unpackedSize":1008384,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEtPVoWzvPvRo33jLPxxWNmBGJj1JDdYv+LoefiecKgvAiBQk55slsjmoqW+0nzB+IweZ0vDVkAReimwFesKe3psHg=="}]},"_npmUser":{"name":"azzerotec","email":"bruno.azzi@azzero.com.br"},"maintainers":[{"name":"azzerotec","email":"bruno.azzi@azzero.com.br"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-linear_1.1.0_1745849946521_0.6121675929388561"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-27T14:56:33.764Z","modified":"2025-04-28T14:19:06.880Z","1.0.9":"2025-04-27T14:56:34.118Z","1.1.0":"2025-04-28T14:19:06.721Z"},"bugs":{"url":"https://github.com/azzerotec/mcp-linear/issues"},"author":{"name":"Alexey Elizarov","email":"alex.elizarov1@gmail.com"},"license":"MIT","homepage":"https://github.com/azzerotec/mcp-linear#readme","keywords":["mcp","linear","cursor","claude","ai","model-context-protocol","project-management","smithery"],"repository":{"type":"git","url":"git+https://github.com/azzerotec/mcp-linear.git"},"description":"A Model Context Protocol (MCP) server implementation for the Linear GraphQL API that enables AI assistants to interact with Linear project management systems.","maintainers":[{"name":"azzerotec","email":"bruno.azzi@azzero.com.br"}],"readme":"

\n \"Linear\n

\n\n# MCP Linear\n\nA Model Context Protocol (MCP) server implementation for the Linear GraphQL API that enables AI assistants to interact with Linear project management systems.\n\n![MCP Linear](https://img.shields.io/badge/MCP-Linear-blue)\n[![npm version](https://img.shields.io/npm/v/@azzerotec/mcp-linear.svg)](https://www.npmjs.com/package/@azzerotec/mcp-linear)\n[![smithery badge](https://smithery.ai/badge/@azzerotec/mcp-linear)](https://smithery.ai/server/@azzerotec/mcp-linear)\n\n\n \n\n\n## Features\n\nMCP Linear bridges the gap between AI assistant and Linear (project management tool) by implementing the MCP protocol. This allows to:\n\n- Retrieve issues, projects, teams, and other data from Linear\n- Create and update issues\n- Change issue status\n- Assign issues to team members\n- Add comments\n- Create projects and teams\n\n## Example prompts\n\nOnce connected, you can use prompts like:\n\n- \"Show me all my Linear issues\"\n- \"Create a new issue titled 'Fix login bug' in the Frontend team\"\n- \"Change the status of issue FE-123 to 'In Progress'\"\n- \"Assign issue BE-456 to John Smith\"\n- \"Add a comment to issue UI-789: 'This needs to be fixed by Friday'\"\n\n## Installation\n\n### Getting Your Linear API Token\n\nTo use MCP Linear, you'll need a Linear API token. Here's how to get one:\n\n1. Log in to your Linear account at [linear.app](https://linear.app)\n2. Click on organization avatar (in the top-left corner)\n3. Select **Settings**\n4. Navigate to **Security & access** in the left sidebar\n5. Under **Personal API Keys** click **New API Key**\n6. Give your key a name (e.g., `MCP Linear Integration`)\n7. Copy the generated API token and store it securely - you won't be able to see it again!\n\n### Installing via [Smithery](https://smithery.ai/server/@azzerotec/mcp-linear) (Recommended)\n\n- To install MCP Linear for Cursor:\n\n```bash\nnpx -y @smithery/cli install @azzerotec/mcp-linear --client cursor\n```\n\n- To install MCP Linear for Claude Desktop:\n\n```bash\nnpx -y @smithery/cli install @azzerotec/mcp-linear --client claude\n```\n\n### Manual Configuration\n\nAdd the following to your MCP settings file:\n\n```json\n{\n \"mcpServers\": {\n \"linear\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@azzerotec/mcp-linear\"],\n \"env\": {\n \"LINEAR_API_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\n#### Client-Specific Configuration Locations\n\n- Cursor: `~/.cursor/mcp.json`\n- Claude Desktop: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Claude VSCode Extension: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`\n- GoMCP: `~/.config/gomcp/config.yaml`\n\n### Manual run\n\nPrerequisites\n\n- Node.js (v18+)\n- NPM or Yarn\n- Linear API token\n\n```bash\n# Install globally\nnpm install -g @azzerotec/mcp-linear\n\n# Or clone and install locally\ngit clone https://github.com/azzerotec/mcp-linear.git\ncd mcp-linear\nnpm install\nnpm link # Makes the package available globally\n```\n\n#### Running the Server\n\nRun the server with your Linear API token:\n\n```bash\nmcp-linear --token YOUR_LINEAR_API_TOKEN\n```\n\nOr set the token in your environment and run without arguments:\n\n```bash\nexport LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN\nmcp-linear\n```\n\n## Available Tools\n\nSee [TOOLS.md](https://github.com/azzerotec/mcp-linear/blob/main/TOOLS.md) for a complete list of available tools and planned features.\n\n## Development\n\nSee [DEVELOPMENT.md](https://github.com/azzerotec/mcp-linear/blob/main/DEVELOPMENT.md) for more information on how to develop locally.\n\n## Related Projects\n\n[azzerotec/cursor-memory-bank](https://github.com/azzerotec/cursor-memory-bank) - If you are a developer seeking to enhance your workflow with Cursor, consider giving it a try.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n","readmeFilename":"README.md"}