{"id":26648498,"url":"https://github.com/tacticlaunch/mcp-linear","last_synced_at":"2026-05-03T22:03:00.756Z","repository":{"id":283999765,"uuid":"953530564","full_name":"tacticlaunch/mcp-linear","owner":"tacticlaunch","description":"MCP server that enables AI assistants to interact with Linear project management system through natural language, allowing users to retrieve, create, and update issues, projects, and teams.","archived":false,"fork":false,"pushed_at":"2026-04-26T22:04:57.000Z","size":672,"stargazers_count":133,"open_issues_count":7,"forks_count":29,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-04-27T00:02:54.843Z","etag":null,"topics":["claude","cursor","linear","mcp"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tacticlaunch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-23T15:27:19.000Z","updated_at":"2026-04-26T22:05:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"8ab4b291-8549-4e6a-ad75-b7c8a1954e78","html_url":"https://github.com/tacticlaunch/mcp-linear","commit_stats":null,"previous_names":["tacticlaunch/mcp-linear"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/tacticlaunch/mcp-linear","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tacticlaunch%2Fmcp-linear","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tacticlaunch%2Fmcp-linear/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tacticlaunch%2Fmcp-linear/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tacticlaunch%2Fmcp-linear/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tacticlaunch","download_url":"https://codeload.github.com/tacticlaunch/mcp-linear/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tacticlaunch%2Fmcp-linear/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32320763,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["claude","cursor","linear","mcp"],"created_at":"2025-03-25T00:02:01.916Z","updated_at":"2026-05-03T22:03:00.750Z","avatar_url":"https://github.com/tacticlaunch.png","language":"TypeScript","funding_links":[],"categories":["Productivity","👥 Community Contributions","Project Management Mcp Servers","Community Servers","MCP 服务器精选列表","پیاده‌سازی‌های سرور","Other Tools and Integrations","MCP Servers","TypeScript","Task and Project Management","🌐 Web Development","📚 Projects (2474 total)","Productivity \u0026 Workflow","🗂️ Categories","Table of Contents","Server Implementations"],"sub_categories":["Project Management","Productivity \u0026 Knowledge Management","🛠️ 效率工具与集成 (Office, Project Management, Notes, etc.)","🛠️ \u003ca name=\"other-tools-and-integrations\"\u003e\u003c/a\u003eسایر ابزارها و یکپارچه‌سازی‌ها","How to Submit","🛠️ Other Tools and Integrations","MCP Servers","🏢 Enterprise","Workflow Automation","🛠️ \u003ca name=\"other-tools-and-integrations\"\u003e\u003c/a\u003eOther Tools and Integrations"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/tacticlaunch/mcp-linear/blob/main/docs/linear-app-icon.png?raw=true\" alt=\"Linear App Icon\" width=\"250\" height=\"250\"\u003e\n\u003c/p\u003e\n\n# MCP Linear\n\nA Model Context Protocol (MCP) server for the Linear GraphQL API, built for real project-management workflows — not just basic issue CRUD.\n\n![MCP Linear](https://img.shields.io/badge/MCP-Linear-blue)\n[![npm version](https://img.shields.io/npm/v/@tacticlaunch/mcp-linear.svg)](https://www.npmjs.com/package/@tacticlaunch/mcp-linear)\n\n\u003ca href=\"https://glama.ai/mcp/servers/@tacticlaunch/mcp-linear\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@tacticlaunch/mcp-linear/badge\" /\u003e\n\u003c/a\u003e\n\n## Features\n\nMCP Linear bridges AI assistants and Linear by implementing the MCP protocol. With it you can:\n\n- Retrieve issues, projects, teams, cycles, milestones, roadmaps, and documents\n- Create and update issues, change status, assign, and comment\n- Manage projects, project updates, milestones, roadmaps, saved views, and favorites\n- Work with templates, custom fields, webhooks, and attachments\n- Read notifications, subscriptions, sessions, audits, and integrations without leaving MCP\n- Inspect rate-limit and server health before running heavy planning sessions\n\nSee [`TOOLS.md`](./TOOLS.md) for the full inventory.\n\n### MCP-native resources and prompts\n\nThe server exposes MCP resources and prompts in addition to tools, including:\n\n- Resources: `linear://viewer`, `linear://organization`, `linear://teams`, `linear://projects`, `linear://project/{id}`, `linear://project/{id}/issues`, `linear://project/{id}/documents`, `linear://issue/{id}`, `linear://document/{id}`, `linear://roadmap/{id}`, `linear://milestone/{id}`, `linear://rate-limit`\n- Prompts: `summarize-project-status`, `draft-project-update`, `triage-issue`, `summarize-document`\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- \"Show all open issues in this project grouped by milestone and cycle\"\n- \"Draft a weekly project update from the current Linear state\"\n- \"Find the newest documents related to a project and summarize the key decisions\"\n\n## Installation\n\n### Getting your Linear API token\n\n1. Log in to your Linear account at [linear.app](https://linear.app)\n2. Click on your organization avatar (top-left corner)\n3. Select **Settings**\n4. Navigate to **Security \u0026 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 [add-mcp](https://github.com/neondatabase/add-mcp) (Recommended)\n\n`add-mcp` installs the server into Claude Code, Cursor, Codex, VS Code, Claude Desktop, and many other MCP-aware agents with a single command:\n\n```bash\nnpx add-mcp @tacticlaunch/mcp-linear --env LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN\n```\n\nAdd `-g` to install globally instead of into the current project. See the [add-mcp docs](https://github.com/neondatabase/add-mcp) for the full agent list and flags.\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\", \"@tacticlaunch/mcp-linear\"],\n      \"env\": {\n        \"LINEAR_API_TOKEN\": \"\u003cYOUR_TOKEN\u003e\"\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 @tacticlaunch/mcp-linear\n\n# Or clone and install locally\ngit clone https://github.com/tacticlaunch/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## Validation\n\nThe default validation path is:\n\n```bash\nnpm test\nnpm run build\n```\n\n`npm test` runs Jest unit tests and an official MCP SDK smoke test against the built stdio server, covering tool, resource, and prompt registration plus host-compatible schema emission.\n\n## Development\n\nSee [`DEVELOPMENT.md`](./DEVELOPMENT.md) for local development details.\n\n## Links\n\n[tacticlaunch/cursor-memory-bank](https://github.com/tacticlaunch/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`](./LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftacticlaunch%2Fmcp-linear","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftacticlaunch%2Fmcp-linear","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftacticlaunch%2Fmcp-linear/lists"}