Linear Project MCP Server

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

Local serverstdio

What is the Linear Project MCP Server?

Linear Project is an MCP integration. Scope-gated Linear project administration with optional GitHub and Obsidian evidence adapters.

Packages and local setup

The published npm package is @openly-useful/linear-project-mcp-server, version 0.1.0. Its declared MCP transport is stdio.

The package declares LINEAR_API_KEY: Linear API key. Configure this or LINEAR_ACCESS_TOKEN through a protected secret store.; LINEAR_ACCESS_TOKEN: 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: 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..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository · Project website. This profile uses version 0.1.0 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related productivity & project management MCP servers for tools that cover the same kind of work.

Configuration

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