Linear Project MCP Server

What this does

Linear Project exposes a set of tools to Claude over the Model Context Protocol. After you add it to claude_desktop_config.json (snippet above) and restart Claude Desktop, those tools become callable inside any conversation.

Requirements

This server needs the following environment variables to be set before it can run:

LINEAR_API_KEY
LINEAR_ACCESS_TOKEN
LINEAR_ALLOWED_ORGANIZATION_ID
LINEAR_ALLOWED_TEAM_IDS
LINEAR_ALLOWED_PROJECT_IDS
LINEAR_ALLOWED_SCOPE_CODES
GITHUB_TOKEN
GITHUB_ALLOWED_REPOSITORIES
OBSIDIAN_VAULT_PATH
OBSIDIAN_VAULT_NAME
OBSIDIAN_ALLOWED_DIRECTORIES
MCP_WRITES_ENABLED
MCP_WRITE_WINDOW_EXPIRES_AT
MCP_AUDIT_LOG_PATH

Set these via the env object in your MCP config (see claude_desktop_config.json snippet above).

How do I install Linear Project?

Run the Claude Code command in the install section to add Linear Project to Claude Code, or copy the ready-made config for your client from the install section on this page. Restart your client afterwards and the tools appear in your next conversation.

Which clients work with Linear Project?

This page carries setup and config for Claude Code, Claude Desktop, Cursor and VS Code. Any other MCP client that accepts a standard server config can connect to Linear Project as well.

Does Linear Project need an API key?

Yes. Before it can run, set these environment variables: LINEAR_API_KEY, LINEAR_ACCESS_TOKEN, LINEAR_ALLOWED_ORGANIZATION_ID, LINEAR_ALLOWED_TEAM_IDS, LINEAR_ALLOWED_PROJECT_IDS, LINEAR_ALLOWED_SCOPE_CODES, GITHUB_TOKEN, GITHUB_ALLOWED_REPOSITORIES, OBSIDIAN_VAULT_PATH, OBSIDIAN_VAULT_NAME, OBSIDIAN_ALLOWED_DIRECTORIES, MCP_WRITES_ENABLED, MCP_WRITE_WINDOW_EXPIRES_AT, MCP_AUDIT_LOG_PATH. They go in the env block of your MCP config.