{"_id":"@mseep/linear-mcp","name":"@mseep/linear-mcp","dist-tags":{"latest":"78.0.1"},"versions":{"78.0.1":{"name":"@mseep/linear-mcp","version":"78.0.1","description":"A Linear MCP server for interacting with Linear's API","type":"module","bin":{"linear-mcp":"build/index.js"},"scripts":{"build":"tsc && chmod +x build/index.js","prepare":"npm run build","watch":"tsc --watch","inspector":"npx @modelcontextprotocol/inspector build/index.js","publish:patch":"npm version patch && npm publish","publish:minor":"npm version minor && npm publish","publish:major":"npm version major && npm publish"},"dependencies":{"@linear/sdk":"37.0.0","@modelcontextprotocol/sdk":"0.6.0","dotenv":"16.4.7"},"devDependencies":{"@types/node":"^20.11.24","typescript":"^5.3.3"},"keywords":["linear","mcp","model-context-protocol","cli","roo","cline","cursor","windsurf","claude","mseep","mcp-server"],"author":{"name":"Ibraheem Abdul-Malik"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/ibraheem4/linear-mcp.git"},"publishConfig":{"access":"public"},"engines":{"node":">=18"},"publisher":"mseep","_id":"@mseep/linear-mcp@78.0.1","gitHead":"f04265c803ef3897a66e397363960b7a428e1cdf","bugs":{"url":"https://github.com/ibraheem4/linear-mcp/issues"},"homepage":"https://github.com/ibraheem4/linear-mcp#readme","_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-DTxIGeawHyCuiU46+ru4GfnfSYpsjbGT8+0q88pSx4Ul8tWmXW5F/8grkIBely5tJYsEAP6lEQQqxbHA24Q10g==","shasum":"b5cd2360f8c7e4d66894bd6db0f4796d8b029832","tarball":"https://registry.npmjs.org/@mseep/linear-mcp/-/linear-mcp-78.0.1.tgz","fileCount":6,"unpackedSize":42333,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGqi3ymdyIJ2UezI93JqEVlSpki6FPaesVJdJswhao8CAiEAuzIqG1Jbi4ghDlNwmvuUIppE/QrfhJRlXCsb3YceHVk="}]},"_npmUser":{"name":"skydeckai","email":"support@skydeck.ai"},"directories":{},"maintainers":[{"name":"skydeckai","email":"support@skydeck.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/linear-mcp_78.0.1_1744854801604_0.3924794761498096"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-17T01:53:21.487Z","78.0.1":"2025-04-17T01:53:21.824Z","modified":"2025-04-17T01:53:22.127Z"},"maintainers":[{"name":"skydeckai","email":"support@skydeck.ai"}],"description":"A Linear MCP server for interacting with Linear's API","homepage":"https://github.com/ibraheem4/linear-mcp#readme","keywords":["linear","mcp","model-context-protocol","cli","roo","cline","cursor","windsurf","claude","mseep","mcp-server"],"repository":{"type":"git","url":"git+https://github.com/ibraheem4/linear-mcp.git"},"author":{"name":"Ibraheem Abdul-Malik"},"bugs":{"url":"https://github.com/ibraheem4/linear-mcp/issues"},"license":"MIT","readme":"# Linear MCP Server\n\n> Note: This is a custom implementation. For the official Cline Linear MCP server, see [cline/linear-mcp](https://github.com/cline/linear-mcp).\n\nA Model Context Protocol (MCP) server that provides tools for interacting with Linear's API, enabling AI agents to manage issues, projects, and teams programmatically through the Linear platform.\n\n## Features\n\n- **Issue Management**\n\n  - Create new issues with customizable properties (title, description, team, assignee, priority, labels)\n  - List issues with flexible filtering options (team, assignee, status)\n  - Update existing issues (title, description, status, assignee, priority)\n\n- **Team Management**\n\n  - List all teams in the workspace\n  - Access team details including ID, name, key, and description\n\n- **Project Management**\n  - List all projects with optional team filtering\n  - View project details including name, description, state, and associated teams\n\n## Prerequisites\n\n- Node.js (v16 or higher)\n- A Linear account with API access\n- Linear API key with appropriate permissions\n\n## Quick Start\n\n1. Get your Linear API key from [Linear's Developer Settings](https://linear.app/settings/api)\n\n2. Run with your API key:\n\n```bash\nLINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp\n```\n\nOr set it in your environment:\n\n```bash\nexport LINEAR_API_KEY=your-api-key\nnpx @ibraheem4/linear-mcp\n```\n\n## Development Setup\n\n1. Clone the repository:\n\n```bash\ngit clone [repository-url]\ncd linear-mcp\n```\n\n2. Install dependencies:\n\n```bash\nnpm install\n```\n\n3. Build the project:\n\n```bash\nnpm run build\n```\n\n## Running with Inspector\n\nFor local development and debugging, you can use the MCP Inspector:\n\n1. Install supergateway:\n\n```bash\nnpm install -g supergateway\n```\n\n2. Use the included `run.sh` script:\n\n```bash\nchmod +x run.sh\nLINEAR_API_KEY=your-api-key ./run.sh\n```\n\n3. Access the Inspector:\n   - Open [localhost:1337](http://localhost:1337) in your browser\n   - The Inspector connects via Server-Sent Events (SSE)\n   - Test and debug tool calls through the Inspector interface\n\n## Configuration\n\nConfigure the MCP server in your settings file based on your client:\n\n### For Claude Desktop\n\n- MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"linear-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/linear-mcp/build/index.js\"],\n      \"env\": {\n        \"LINEAR_API_KEY\": \"your-api-key-here\"\n      },\n      \"disabled\": false,\n      \"alwaysAllow\": []\n    }\n  }\n}\n```\n\n### For VS Code Extension (Cline)\n\nLocation: `~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"linear-mcp\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/linear-mcp/build/index.js\"],\n      \"env\": {\n        \"LINEAR_API_KEY\": \"your-api-key-here\"\n      },\n      \"disabled\": false,\n      \"alwaysAllow\": []\n    }\n  }\n}\n```\n\n### For Cursor ([cursor.sh](https://cursor.sh))\n\nFor Cursor, the server must be run with the full path:\n\n```bash\nnode /Users/ibraheem/Projects/linear-mcp/build/index.js\n```\n\n## Available Tools\n\n### create_issue\n\nCreates a new issue in Linear.\n\n```typescript\n{\n  title: string;          // Required: Issue title\n  description?: string;   // Optional: Issue description (markdown supported)\n  teamId: string;        // Required: Team ID\n  assigneeId?: string;   // Optional: Assignee user ID\n  priority?: number;     // Optional: Priority (0-4)\n  labels?: string[];     // Optional: Label IDs to apply\n}\n```\n\n### list_issues\n\nLists issues with optional filters.\n\n```typescript\n{\n  teamId?: string;      // Optional: Filter by team ID\n  assigneeId?: string;  // Optional: Filter by assignee ID\n  status?: string;      // Optional: Filter by status\n  first?: number;       // Optional: Number of issues to return (default: 50)\n}\n```\n\n### update_issue\n\nUpdates an existing issue.\n\n```typescript\n{\n  issueId: string;       // Required: Issue ID\n  title?: string;        // Optional: New title\n  description?: string;  // Optional: New description\n  status?: string;      // Optional: New status\n  assigneeId?: string;  // Optional: New assignee ID\n  priority?: number;    // Optional: New priority (0-4)\n}\n```\n\n### list_teams\n\nLists all teams in the workspace. No parameters required.\n\n### list_projects\n\nLists all projects with optional filtering.\n\n```typescript\n{\n  teamId?: string;     // Optional: Filter by team ID\n  first?: number;      // Optional: Number of projects to return (default: 50)\n}\n```\n\n### get_issue\n\nGets detailed information about a specific issue.\n\n```typescript\n{\n  issueId: string; // Required: Issue ID\n}\n```\n\n## Development\n\nFor development with auto-rebuild:\n\n```bash\nnpm run watch\n```\n\n## Error Handling\n\nThe server includes comprehensive error handling for:\n\n- Invalid API keys\n- Missing required parameters\n- Linear API errors\n- Invalid tool requests\n\nAll errors are properly formatted and returned with descriptive messages.\n\n## Technical Details\n\nBuilt with:\n\n- TypeScript\n- Linear SDK (@linear/sdk v37.0.0)\n- MCP SDK (@modelcontextprotocol/sdk v0.6.0)\n\nThe server uses stdio for communication and implements the Model Context Protocol for seamless integration with AI agents.\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-03972f077c285da2acd3e2295889c4f6"}