Linear MCP — Auth Setup
Linear uses personal API keys to authenticate requests to your workspace.
1. Get your credentials
- Open the Linear API settings page (opens Linear — we never see your key)
- Under Personal API keys, click Create new API key
- Give it a label and copy the key — it will not be shown again after you leave the page
2. Set environment variables
macOS / Linux — add to ~/.zshrc or ~/.bashrc:
export LINEAR_API_KEY=YOUR_API_KEY_HERE
Then run source ~/.zshrc (or open a new terminal).
Windows — run in Command Prompt (then restart):
setx LINEAR_API_KEY "YOUR_API_KEY_HERE"
3. Verify
npx claude-skills doctor
You should see ✅ next to the Linear MCP entry. If you see ❌, confirm the key is set: echo $LINEAR_API_KEY.
4. Restart Claude Code
Quit and reopen Claude Code (or run /mcp list inside Claude Code to confirm the Linear MCP appears).

