Linear MCP Server
by MCP-Mirror
This is a Model Context Protocol (MCP) server for Linear, allowing Claude to interact with Linear's API to manage teams, issues, projects, and cycles. It provides tools to get teams, search issues, manage projects, and more.
Last updated: N/A
What is Linear MCP Server?
The Linear MCP Server is a tool that enables interaction with the Linear API through a Model Context Protocol (MCP). It allows applications like Claude to manage Linear teams, issues, projects, and cycles programmatically.
How to use Linear MCP Server?
To use the server, first install and configure it with your Linear OAuth token. Then, use the provided use_mcp_tool function with the server name and desired tool (e.g., linear_search_issues) along with the required arguments. Refer to the usage section in the documentation for specific tool arguments.
Key features of Linear MCP Server
Get all teams with their states and labels
Search for issues with filtering and pagination
Get all cycles for a team
Get all projects
Create a new issue
Update an existing issue
Use cases of Linear MCP Server
Automated issue creation and assignment
Programmatic issue searching and filtering
Integration with AI models for task management
Reporting and analytics on Linear data
FAQ from Linear MCP Server
How do I get a Linear OAuth token?
How do I get a Linear OAuth token?
Create a Linear OAuth application at https://linear.app/settings/api/applications. Set the redirect URI to http://localhost:3000/callback and create a USER based developer token.
What do I do if the connection fails?
What do I do if the connection fails?
Check your MCP configuration, Linear tokens, and environment variables. Ensure the server path is correct and the server is not disabled. Also, verify the Linear API status.
How do I test the server connection?
How do I test the server connection?
Use the linear_search_issues tool with a small first value. If you see a list of issues, the connection is working.
What permissions should I grant to the Linear OAuth application?
What permissions should I grant to the Linear OAuth application?
Only grant the permissions needed for the server to function. Limit permissions to minimize security risks.
Where can I find the test client?
Where can I find the test client?
The test client is included in the repository and can be run with node test-client.js.