Linear MCP Server

What is Linear MCP Server?

Linear MCP Server is a Model Context Protocol (MCP) server that provides tools to interact with the Linear API, allowing you to fetch tasks and their associated details.

How to use Linear MCP Server?

Install dependencies with npm install, build the server with npm run build, then configure your Linear API key in the MCP settings file. Use the server via MCP client commands, for example: use_mcp_tool server_name: linear tool_name: get_tasks arguments: { "status": "In Progress" }.

Key features of Linear MCP Server

• Fetch tasks with optional filtering by status, assignee, or team
• Retrieve detailed information for a specific task by ID
• List all teams in the Linear workspace
• List all users in the Linear workspace
• Configure a maximum of 100 tasks per query (default 20)
• Requires a personal Linear API key for authentication

Use cases of Linear MCP Server

• View tasks assigned to a specific person with a given status
• Get full details of a particular task for deeper context
• List all active teams to reference team IDs or names
• List all workspace users for assignee filtering or identification

FAQ from Linear MCP Server

What dependencies are required to run Linear MCP Server?

You need Node.js and npm to install dependencies and build the server.

How is authentication handled?

A Linear personal API key is required; obtain it from Linear (Settings > API > Personal API Keys) and configure it in the MCP settings file.

Where does data come from and where is it stored?

All data is retrieved from the Linear API; no local storage of data is mentioned in the README.

Are there any limits on the tools?

The get_tasks tool has a default limit of 20 tasks and a maximum limit of 100 tasks per query.

What transport and authentication method does the server use?

The server uses the Model Context Protocol (MCP) as its transport; authentication is via a static API key configured in the settings file.