Linear Project MCP Server

org.openlyuseful/linear-project

Repository Registry

What is the Linear Project MCP server?

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

How to install Linear Project

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

LINEAR_API_KEY
secret
Linear API key. Configure this or LINEAR_ACCESS_TOKEN through a protected secret store.
LINEAR_ACCESS_TOKEN
secret
Linear OAuth access token. Configure this or LINEAR_API_KEY through a protected secret store.
LINEAR_ALLOWED_ORGANIZATION_ID
required
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
secret
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.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linear-project": {
      "command": "npx",
      "args": [
        "-y",
        "@openly-useful/linear-project-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "<YOUR_LINEAR_API_KEY>",
        "LINEAR_ACCESS_TOKEN": "<YOUR_LINEAR_ACCESS_TOKEN>",
        "LINEAR_ALLOWED_ORGANIZATION_ID": "<YOUR_LINEAR_ALLOWED_ORGANIZATION_ID>",
        "LINEAR_ALLOWED_TEAM_IDS": "<YOUR_LINEAR_ALLOWED_TEAM_IDS>",
        "LINEAR_ALLOWED_PROJECT_IDS": "<YOUR_LINEAR_ALLOWED_PROJECT_IDS>",
        "LINEAR_ALLOWED_SCOPE_CODES": "<YOUR_LINEAR_ALLOWED_SCOPE_CODES>",
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>",
        "GITHUB_ALLOWED_REPOSITORIES": "<YOUR_GITHUB_ALLOWED_REPOSITORIES>",
        "OBSIDIAN_VAULT_PATH": "<YOUR_OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_VAULT_NAME": "<YOUR_OBSIDIAN_VAULT_NAME>",
        "OBSIDIAN_ALLOWED_DIRECTORIES": "<YOUR_OBSIDIAN_ALLOWED_DIRECTORIES>",
        "MCP_WRITES_ENABLED": "<YOUR_MCP_WRITES_ENABLED>",
        "MCP_WRITE_WINDOW_EXPIRES_AT": "<YOUR_MCP_WRITE_WINDOW_EXPIRES_AT>",
        "MCP_AUDIT_LOG_PATH": "<YOUR_MCP_AUDIT_LOG_PATH>"
      }
    }
  }
}

Related MCP servers

Operations Pulse

Maintained

Local-first operational pulses, durable ticket memory, and governed connection discovery.

JavaScript

MIT

View repository →

Project Status

Active

Read-only project readiness, dependency, evidence, and bounded local activity views.

JavaScript

Apache-2.0

View repository →

RunGlance

Active

Read-only local progress, usage, lock state, work lists, and verified run receipts.

JavaScript

Apache-2.0

View repository →

OpenOak

Secure AI access to OpenOak tasks, notes, and Kanban boards.

View repository →

Open Standing

Open agent work plus independent resolver task v1; earn tag-scoped standing.

Open Task Relay

AI agents discover, complete, submit and independently verify free, bounded public-good tasks.