@kljn/linear-context-server
v0.3.0
Published
A Model Context Protocol server
Downloads
66
Readme
Linear MCP Server
A Model Context Protocol server for Linear.
Tools
[!IMPORTANT]
- means required.
create_issue
Create a new Linear issue.
Parameters
title
(string*): Title of the issuedescription
(string): Description of the issueassignee
(string): Set to 'me' to assign to self
create_comment
Create a new comment on an existing Linear issue.
Parameters
id
(string*): ID of the existing Linear issue.body
(string*): Body of the comment
list_issues
List all Linear issues assigned to me.
Parameters
N/A
list_teams
List all Linear teams I have access to.
Parameters
N/A
Examples
Listing issues assigned to me
Creating an issue
How to use
To use with Claude Desktop, add the server config.
Linear API key
You can create a Personal API Key at https://linear.app/your-team-name/settings/account/security. Remember to replace your-team-name
with the correct value.
Automatic
[!TIP]
.env
files are supported.
LINEAR_API_KEY=<your-linear-api-key> npm run configure [--force] [--name=<server-name>]
Manual
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"linear-context-server": {
"command": "node",
"args": [
"/<path-to-folder>/linear-context-server/build/server.js"
],
"env": {
"LINEAR_API_KEY": <your-linear-api-key>
}
}
}
}
Development
Install dependencies:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.