Skip to content
MCP server

Linear Project

Scope-gated Linear project administration with optional GitHub and Obsidian evidence…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.0
Listing updated
4 days ago

About Linear Project

Linear Project is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Scope-gated Linear project administration with optional GitHub and Obsidian evidence adapters

Install

Run in a terminal

claude mcp add linear-project --env LINEAR_API_KEY='<LINEAR_API_KEY>' --env LINEAR_ACCESS_TOKEN='<LINEAR_ACCESS_TOKEN>' --env LINEAR_ALLOWED_ORGANIZATION_ID='<LINEAR_ALLOWED_ORGANIZATION_ID>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- npx -y @openly-useful/linear-project-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "linear-project": {
      "command": "npx",
      "args": [
        "-y",
        "@openly-useful/linear-project-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "<LINEAR_API_KEY>",
        "LINEAR_ACCESS_TOKEN": "<LINEAR_ACCESS_TOKEN>",
        "LINEAR_ALLOWED_ORGANIZATION_ID": "<LINEAR_ALLOWED_ORGANIZATION_ID>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "linear-project": {
      "command": "npx",
      "args": [
        "-y",
        "@openly-useful/linear-project-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "<LINEAR_API_KEY>",
        "LINEAR_ACCESS_TOKEN": "<LINEAR_ACCESS_TOKEN>",
        "LINEAR_ALLOWED_ORGANIZATION_ID": "<LINEAR_ALLOWED_ORGANIZATION_ID>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "linear-project": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@openly-useful/linear-project-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "<LINEAR_API_KEY>",
        "LINEAR_ACCESS_TOKEN": "<LINEAR_ACCESS_TOKEN>",
        "LINEAR_ALLOWED_ORGANIZATION_ID": "<LINEAR_ALLOWED_ORGANIZATION_ID>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "linear-project": {
      "command": "npx",
      "args": [
        "-y",
        "@openly-useful/linear-project-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "<LINEAR_API_KEY>",
        "LINEAR_ACCESS_TOKEN": "<LINEAR_ACCESS_TOKEN>",
        "LINEAR_ALLOWED_ORGANIZATION_ID": "<LINEAR_ALLOWED_ORGANIZATION_ID>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "linear-project": {
      "command": "npx",
      "args": [
        "-y",
        "@openly-useful/linear-project-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "<LINEAR_API_KEY>",
        "LINEAR_ACCESS_TOKEN": "<LINEAR_ACCESS_TOKEN>",
        "LINEAR_ALLOWED_ORGANIZATION_ID": "<LINEAR_ALLOWED_ORGANIZATION_ID>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}

Configuration

  • LINEAR_API_KEYLinear API key. Configure this or LINEAR_ACCESS_TOKEN through a protected secret store.
  • LINEAR_ACCESS_TOKENLinear OAuth access token. Configure this or LINEAR_API_KEY through a protected secret store.
  • LINEAR_ALLOWED_ORGANIZATION_IDExact Linear organization ID allowed for scoped operations.Required
  • LINEAR_ALLOWED_TEAM_IDSComma-separated exact Linear team IDs. Required when reusing an existing team; leave empty only while bootstrapping a new dedicated team.
  • LINEAR_ALLOWED_PROJECT_IDSComma-separated exact Linear project IDs. Required after project discovery; leave empty only during initial bootstrap.
  • LINEAR_ALLOWED_SCOPE_CODESComma-separated exact scope codes. Leave empty for read-only capability inspection.
  • GITHUB_TOKENOptional GitHub token used only by the read-only evidence adapter.
  • GITHUB_ALLOWED_REPOSITORIESComma-separated owner/repository allowlist for GitHub evidence reads.
  • OBSIDIAN_VAULT_PATHOptional normalized absolute path to an Obsidian vault.
  • OBSIDIAN_VAULT_NAMEOptional expected Obsidian vault directory name.
  • OBSIDIAN_ALLOWED_DIRECTORIESComma-separated vault-relative directories allowed for Obsidian operations.
  • MCP_WRITES_ENABLEDGlobal mutation gate. Keep false unless opening a separately bounded write window.
  • MCP_WRITE_WINDOW_EXPIRES_ATFuture RFC3339 expiry for a write window; enabled windows may last at most 60 minutes.
  • MCP_AUDIT_LOG_PATHOptional normalized absolute path for the append-only NDJSON operation audit.

Pricing

Open source

Linear Project FAQ

Is Linear Project free?

Yes. Linear Project is open source, so you can use and self-host it for free.

How do I add Linear Project to Claude Code?

Run this command in your terminal: claude mcp add linear-project --env LINEAR_API_KEY='<LINEAR_API_KEY>' --env LINEAR_ACCESS_TOKEN='<LINEAR_ACCESS_TOKEN>' --env LINEAR_ALLOWED_ORGANIZATION_ID='<LINEAR_ALLOWED_ORGANIZATION_ID>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- npx -y @openly-useful/linear-project-mcp-server

What are the best alternatives to Linear Project?

The closest alternatives to Linear Project are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to Linear Project

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media