{"id":26775478,"url":"https://github.com/anoncam/linear-mcp","last_synced_at":"2026-04-28T22:32:45.679Z","repository":{"id":284969140,"uuid":"956238456","full_name":"anoncam/linear-mcp","owner":"anoncam","description":"A Linear MCP implementation that handles all Linear resource types.","archived":false,"fork":false,"pushed_at":"2025-03-28T16:24:15.000Z","size":78,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-28T17:41:02.433Z","etag":null,"topics":["linear-app","mcp","mcp-server","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anoncam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-27T23:28:09.000Z","updated_at":"2025-03-28T16:59:29.000Z","dependencies_parsed_at":"2025-03-28T17:51:30.198Z","dependency_job_id":null,"html_url":"https://github.com/anoncam/linear-mcp","commit_stats":null,"previous_names":["anoncam/linear-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anoncam%2Flinear-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anoncam%2Flinear-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anoncam%2Flinear-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anoncam%2Flinear-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anoncam","download_url":"https://codeload.github.com/anoncam/linear-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246131335,"owners_count":20728303,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linear-app","mcp","mcp-server","typescript"],"created_at":"2025-03-29T03:18:28.968Z","updated_at":"2026-04-28T22:32:40.659Z","avatar_url":"https://github.com/anoncam.png","language":"TypeScript","funding_links":[],"categories":["🌐 Web Development","Business \u0026 Productivity"],"sub_categories":[],"readme":"# Linear MCP Server\n\nA Model Context Protocol (MCP) server for Linear, providing AI assistants with access to Linear's project management capabilities.\n\n## Features\n\n- **Resources:** Access issues, projects, teams, users, roadmaps, documents, initiatives, and more\n- **Tools:** Create and update issues, manage projects, search, link projects to initiatives\n- **Prompts:** Templates for issue creation, bug reports, feature requests, and more\n\n## Setup\n\n### Prerequisites\n\n- Node.js 18 or later\n- A Linear API key\n\n### Installation\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/yourusername/linear-mcp.git\n   cd linear-mcp\n   ```\n\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n\n3. Create a `.env` file with your Linear API key:\n   ```\n   LINEAR_API_KEY=your_linear_api_key_here\n   ```\n\n4. Build the project:\n   ```bash\n   npm run build\n   ```\n\n## Usage\n\n### Command-line (stdio)\n\nTo run the server with stdio transport (for use with CLI tools that support MCP):\n\n```bash\nnpm start\n```\n\nOr:\n\n```bash\nnode dist/index.js stdio\n```\n\n### HTTP Server (for remote connections)\n\nTo run the server as an HTTP service with Server-Sent Events (SSE):\n\n```bash\nnode dist/index.js http\n```\n\nThis will start an HTTP server on port 3000 (configurable via PORT environment variable).\n\n### Development Mode\n\nTo run in development mode with automatic reloading:\n\n```bash\nnpm run dev\n```\n\n### Claude Desktop Integration\n\nTo use this server with Claude Desktop:\n\n1. Build the project:\n   ```bash\n   npm run build\n   ```\n\n2. In Claude Desktop, go to Settings → Advanced → MCP Configuration.\n\n3. Add the following configuration (adjust paths to match your installation):\n   ```json\n   {\n     \"mcpServers\": {\n       \"linear\": {\n         \"command\": \"node\",\n         \"args\": [\n           \"/path/to/linear-mcp/dist/index.js\"\n         ],\n         \"env\": {\n           \"LINEAR_API_KEY\": \"your_linear_api_key_here\"\n         }\n       }\n     }\n   }\n   ```\n\n4. Save the configuration and restart Claude Desktop.\n\nAlternatively, you can copy the provided `claude-desktop-config.json` file and modify the paths to match your installation.\n\n## Resources\n\nThe server provides access to all major Linear entities as resources:\n\n### Core Resources\n- **Issues:** `linear://issues` and `linear://issues/{id}`\n- **Teams:** `linear://teams` and `linear://teams/{id}`\n- **Projects:** `linear://projects` and `linear://projects/{id}`\n- **Users:** `linear://users` and `linear://users/{id}`\n- **Initiatives:** `linear://initiatives` and `linear://initiatives/{id}`\n\n### Additional Resources\n- **Roadmaps:** `linear://roadmaps` and `linear://roadmaps/{id}`\n- **Milestones:** `linear://milestones` and `linear://milestones/{id}`\n- **Documents:** `linear://documents` and `linear://documents/{id}`\n- **Integrations:** `linear://integrations` and `linear://integrations/{id}`\n- **Organization:** `linear://organization`\n\n### Specialized Resources\n- `linear://teams/{teamId}/issues` - Issues for a specific team\n- `linear://users/{userId}/issues` - Issues assigned to a specific user\n- `linear://projects/{projectId}/issues` - Issues in a specific project\n- `linear://teams/{teamId}/states` - Workflow states for a team\n- `linear://teams/{teamId}/labels` - Labels for a team\n- `linear://teams/{teamId}/cycles` - Cycles for a team\n- `linear://teams/{teamId}/members` - Members of a team\n- `linear://teams/{teamId}/documents` - Documents for a team\n- `linear://projects/{projectId}/documents` - Documents for a project\n- `linear://projects/{projectId}/initiative` - Initiative associated with a project\n- `linear://initiatives/{initiativeId}/projects` - Projects associated with an initiative\n- `linear://milestones/{milestoneId}/projects` - Projects for a milestone\n- `linear://organization/subscription` - Organization subscription details\n- `linear://organization/auth-services` - Organization authentication services\n- `linear://integration-services` - Available integration services\n\n## Tools\n\nThe server provides tools for:\n\n- **Issue Management**\n  - Creating new issues\n  - Updating existing issues\n  - Adding comments to issues\n\n- **Project Management**\n  - Creating new projects\n  - Updating existing projects\n  - Adding issues to projects\n\n- **Initiative Management**\n  - Creating initiatives\n  - Linking projects to initiatives\n  - Unlinking projects from initiatives\n\n- **Search Capabilities**\n  - Comprehensive search across Linear entities\n  - Finding issues with specific criteria\n\n## Prompts\n\nThe server provides prompt templates for:\n\n- **Issue Related**\n  - Creating new issues\n  - Creating bug reports\n  - Creating feature requests\n\n- **Project Related**\n  - Creating new projects\n  - Planning projects with issues\n  - Creating project status updates\n\n## Testing\n\nTest with the MCP Inspector:\n\n```bash\nnpx @modelcontextprotocol/inspector stdio -- npm start\n```\n\nOr, if running in HTTP mode, open the MCP Inspector in your browser and connect to your server's URL.\n\n## Environment Variables\n\n- `LINEAR_API_KEY` (required): Your Linear API key\n- `SERVER_PORT` (optional): Port for HTTP server (default: 3000)\n- `LOG_LEVEL` (optional): Logging level (default: info)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanoncam%2Flinear-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanoncam%2Flinear-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanoncam%2Flinear-mcp/lists"}