MCP.so
Sign In

Linear MCP Server

@cpropster

Basic information

Category

Version Control

License

MIT

Transports

stdio

Author

cpropster

About Linear MCP Server

MCP server for Linear integration

Linear MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "linear-mcp-server-cpropster": {
      "command": "node",
      "args": [
        "test-client.js"
      ]
    }
  }
}

Linear MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

Frequently asked questions

1

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`.

2

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.

3

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`.

4

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.

5

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.

Comments

More Version Control MCP servers