a private MCP server for accessing Linear
An MCP server for interacting with Linear's API. This server provides a set of tools for managing Linear issues, projects, and teams through Cline.
npm install
.env.example
to .env
:
cp .env.example .env
The server supports two authentication methods:
.env
file:
LINEAR_API_KEY=your_api_key
.env
:
LINEAR_CLIENT_ID=your_oauth_client_id
LINEAR_CLIENT_SECRET=your_oauth_client_secret
LINEAR_REDIRECT_URI=http://localhost:3000/callback
npm run build
npm start
Open your Cline MCP settings file:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Add the Linear MCP server configuration:
{
"mcpServers": {
"linear": {
"command": "node",
"args": ["/path/to/linear-mcp/build/index.js"],
"env": {
"LINEAR_API_KEY": "your_personal_access_token"
},
"disabled": false,
"autoApprove": []
}
}
}
The server currently supports the following operations:
The following features are currently being worked on:
# Install dependencies
npm install
# Run tests
npm test
# Run integration tests (requires LINEAR_API_KEY)
npm run test:integration
# Build the server
npm run build
# Start the server
npm start
Integration tests verify that authentication and API calls work correctly:
npm run test:integration
For OAuth testing:
.env
.skip
from OAuth tests in src/__tests__/auth.integration.test.ts
{ "mcpServers": { "linear-mcp": { "command": "node", "args": [ "/path/to/linear-mcp/build/index.js" ] } } }
Related projects feature coming soon
Will recommend related projects based on sub-categories