What this kind of tool is for
- Create, search, or update items in a notes, docs, or tasks service from your agent.
- Turn a meeting transcript or a long document into a structured summary.
- Keep a daily log or standup digest without leaving the terminal.
How to compare servers like this
- Service scope:
- Confirm the tool covers the exact service and surfaces (pages, tasks, calendars) you need.
- Auth model:
- See whether it uses an API token you control and what permissions that token grants.
- Read vs write:
- Start with read-only workflows; give write access only after the first results look right.
- Maintenance signal:
- For anything tied to a third-party API, prefer tools that track that API's changes.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
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.
LINEAR_API_KEYsecretLinear API key. Configure this or LINEAR_ACCESS_TOKEN through a protected secret store.
LINEAR_ACCESS_TOKENsecretLinear OAuth access token. Configure this or LINEAR_API_KEY through a protected secret store.
LINEAR_ALLOWED_ORGANIZATION_IDrequiredExact Linear organization ID allowed for scoped operations.
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_TOKENsecretOptional 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.
{
"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
Local-first operational pulses, durable ticket memory, and governed connection discovery.

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

RunGlance
Read-only local progress, usage, lock state, work lists, and verified run receipts.
Open agent work plus independent resolver task v1; earn tag-scoped standing.
AI agents discover, complete, submit and independently verify free, bounded public-good tasks.
