Linear
About
Interact with the Linear API to manage issues, projects, and teams.
Details
- Author
- timottowitz
- Categories
- Productivity, Project Management, Automation
Jump to
Setup
Install Linear in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/timottowitz/linear-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
An MCP server for interacting with Linear's API. This server provides a set of tools for managing Linear issues, projects, and teams through Cline.
- Clone the repository
- Install dependencies:
npm install
The server supports two authentication methods:
- Go to Linear Settings
- Navigate to the "Security & access" section
- Find the "Personal API keys" section
- Click "New API key"
- Give the key a descriptive label (e.g. "Cline MCP")
- Copy the generated token immediately
- Add the token to your.envfile:
LINEAR_API_KEY=your_api_key
OAuth Flow (Alternative)NOT IMPLEMENTED
- Create an OAuth application athttps://linear.app/settings/api/applications - Configure OAuth environment variables in.env:
LINEAR_CLIENT_ID=your_oauth_client_id LINEAR_CLIENT_SECRET=your_oauth_client_secret LINEAR_REDIRECT_URI=http://localhost:3000/callback
- macOS:~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Windows:%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Linux:~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Add the Linear MCP server configuration:
{ "mcpServers": { "linear": { "command": "node", "args": ["/path/to/linear-mcp/build/index.js"], "env": { "LINEAR_API_KEY": "your_personal_access_token" }, "disabled": false, "autoApprove": [] } } }
The server currently supports the following operations:
- ✅ Create issues with full field support (title, description, team, project, etc.)
- ✅ Update existing issues (priority, description, etc.)
- ✅ Delete issues (single or bulk deletion)
- ✅ Search issues with filtering
- ✅ Associate issues with projects
- ✅ Create parent/child issue relationships
- ✅ Create projects with associated issues
- ✅ Get project information
- ✅ Associate issues with projects
- ✅ Get team information (with states and workflow details)
- ✅ Access team states and labels
- ✅ API Key authentication
- ✅ Secure token storage
- ✅ Bulk issue creation
- ✅ Bulk issue deletion
- 🚧 Bulk issue updates (parallel processing implemented, needs testing)
The following features are currently being worked on:
- 🚧 Comment functionality (add/edit comments, threading)
- 🚧 Complex search filters
- 🚧 Pagination support for large result sets
- 🚧 Label management (create/update/assign)
- 🚧 Cycle/milestone management
- 🚧 Project template support
- 🚧 Advanced project operations
- 🚧 OAuth flow with automatic token refresh
- 🚧 Rate limiting
- 🚧 Detailed logging
- 🚧 Load testing and optimization
# Install dependencies npm install # Run tests npm test # Run integration tests (requires LINEAR_API_KEY) npm run test:integration # Build the server npm run build # Start the server npm start
Integration tests verify that authentication and API calls work correctly:
- Set up authentication (API Key recommended for testing)
- Run integration tests:
npm run test:integration
- Configure OAuth credentials in.env
- Remove.skipfrom OAuth tests insrc/__tests__/auth.integration.test.ts
- Run integration tests
Perform queries and entity operations in your Fibery workspace.
Keep teams & agents coordinated automatically
Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.
A universal remote MCP server that connects to popular productivity tools such as Notion, Monday, AirTable, and many more.
advanced-math-mcp — MCP server for linear algebra, calculus, and symbolic math. 17 tools with a unified evaluate() expression engine. Supports matrices, eigenvalues, SVD, integrals, limits, derivatives, and more.
An MCP interface for Atlassian products, including Jira and Bitbucket.
The Outcome Backcasting MCP is a strategic planning tool that helps you work backwards from a desired future outcome to identify the specific steps, resources, and dependencies needed to achieve your goals. Unlike traditional forward planning, backcasting starts with your end goal and creates a reverse roadmap to get there.
About A repo-native task graph as plain Markdown files, served to AI agents over MCP and to humans over a clean web UI .
Integrate ClickUp with AI applications to manage tasks, spaces, lists, and folders.
Interact with the ClickUp API to manage tasks, lists, and spaces, automating project planning and workflows.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.


