Linear Project MCP Server

by openly-usefulorg.openlyuseful/linear-projectv0.1.0

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

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained48d ago

Install Linear Project MCP server

claude mcp add linear-project -e LINEAR_API_KEY='<linear-api-key>' -e LINEAR_ACCESS_TOKEN='<linear-access-token>' -e LINEAR_ALLOWED_ORGANIZATION_ID='<linear-allowed-organization-id>' -e GITHUB_TOKEN='<github-token>' -- npx -y @openly-useful/linear-project-mcp-server

{
  "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 (global) or .cursor/mcp.json (project).

{
  "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>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "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 .vscode/mcp.json in your workspace.

{
  "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 ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
LINEAR_API_KEY	—	yes	Linear API key. Configure this or LINEAR_ACCESS_TOKEN through a protected secret store.
LINEAR_ACCESS_TOKEN	—	yes	Linear OAuth access token. Configure this or LINEAR_API_KEY through a protected secret store.
LINEAR_ALLOWED_ORGANIZATION_ID	yes	—	Exact Linear organization ID allowed for scoped operations.
LINEAR_ALLOWED_TEAM_IDS	—	—	Comma-separated exact Linear team IDs. Required when reusing an existing team; leave empty only while bootstrapping a new dedicated team.
LINEAR_ALLOWED_PROJECT_IDS	—	—	Comma-separated exact Linear project IDs. Required after project discovery; leave empty only during initial bootstrap.
LINEAR_ALLOWED_SCOPE_CODES	—	—	Comma-separated exact scope codes. Leave empty for read-only capability inspection.
GITHUB_TOKEN	—	yes	Optional GitHub token used only by the read-only evidence adapter.
GITHUB_ALLOWED_REPOSITORIES	—	—	Comma-separated owner/repository allowlist for GitHub evidence reads.
OBSIDIAN_VAULT_PATH	—	—	Optional normalized absolute path to an Obsidian vault.
OBSIDIAN_VAULT_NAME	—	—	Optional expected Obsidian vault directory name.
OBSIDIAN_ALLOWED_DIRECTORIES	—	—	Comma-separated vault-relative directories allowed for Obsidian operations.
MCP_WRITES_ENABLED	—	—	Global mutation gate. Keep false unless opening a separately bounded write window.
MCP_WRITE_WINDOW_EXPIRES_AT	—	—	Future RFC3339 expiry for a write window; enabled windows may last at most 60 minutes.
MCP_AUDIT_LOG_PATH	—	—	Optional normalized absolute path for the append-only NDJSON operation audit.

Freshness

Maintained — last maintenance signal 48d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-23 · 48d ago · GitHub
Latest release
2026-08-23 · 48d ago · GitHub · v0.2.1
Package published
no data · npm/PyPI
Registry entry updated
2026-08-23 · 48d ago · official registry · v0.1.0

FAQ

›How do I install the Linear Project MCP server in Claude Code?

Run: claude mcp add linear-project -e LINEAR_API_KEY='<linear-api-key>' -e LINEAR_ACCESS_TOKEN='<linear-access-token>' -e LINEAR_ALLOWED_ORGANIZATION_ID='<linear-allowed-organization-id>' -e GITHUB_TOKEN='<github-token>' -- npx -y @openly-useful/linear-project-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Linear Project require an API key?

Yes. It expects LINEAR_ALLOWED_ORGANIZATION_ID, LINEAR_API_KEY, LINEAR_ACCESS_TOKEN, GITHUB_TOKEN, of which 3 are secrets.

›Can I use Linear Project as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Linear Project in the official MCP registry?

Yes, as org.openlyuseful/linear-project.