Linear MCP Server

What is Linear MCP Server?

Linear MCP Server is a Model Context Protocol (MCP) server that allows Claude and other MCP clients to interact with Linear’s API. It enables management of teams, issues, projects, and cycles directly from an AI assistant.

How to use Linear MCP Server?

Clone the repository, install dependencies with npm install, and build with npm run build. Configure your Linear OAuth token and other credentials in the MCP configuration file under the server’s env section. Verify the installation by using the linear_search_issues tool to test the connection.

Key features of Linear MCP Server

• Retrieve 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

• List and search your Linear issues from an AI chat
• Create new issues with custom title, description, priority, and assignee
• Update existing issues (change status, priority, assignee, etc.)
• View team cycles and projects for planning
• Automate common Linear workflows via natural language

FAQ from Linear MCP Server

What tools does Linear MCP Server provide?

It provides six tools: linear_get_teams, linear_search_issues, linear_get_cycles, linear_get_projects, linear_create_issue, and linear_update_issue.

How do I authenticate with Linear?

You need a Linear OAuth token. Create a Linear OAuth application at https://linear.app/settings/api/applications, get a developer token, and set LINEAR_CLIENT_ID, LINEAR_CLIENT_SECRET, LINEAR_REDIRECT_URI, and LINEAR_REFRESH_TOKEN in the MCP configuration environment.

How do I verify the server is working?

After configuration, run the linear_search_issues tool. If successful, it returns a list of issues from your Linear account. You can also run the included test client with node test-client.js.

What are common installation issues?

Common problems include incorrect server path in the MCP config, invalid or expired Linear tokens, missing required environment variables, or the server being disabled in the configuration.

What are the security considerations?

Never commit tokens to version control. Use environment variables instead of hardcoding. Limit permissions on the OAuth application and rotate tokens periodically. All communication with Linear occurs over HTTPS.