Linear Project runs on your own machine — the client starts it, so there is no endpoint to ping. 14 installs a week from npm. Last commit 23 Aug 2026.
Scope-gated Linear project administration with optional GitHub and Obsidian evidence adapters
Today is the operative word: we check Linear Project every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add linear-project -- npx -y @openly-useful/linear-project-mcp-server
{
"mcpServers": {
"linear-project": {
"args": [
"-y",
"@openly-useful/linear-project-mcp-server"
],
"command": "npx"
}
}
}
[mcp_servers.linear-project]
command = "npx"
args = ["-y", "@openly-useful/linear-project-mcp-server"]
{
"mcpServers": {
"linear-project": {
"args": [
"-y",
"@openly-useful/linear-project-mcp-server"
],
"command": "npx"
}
}
}
{
"mcpServers": {
"linear-project": {
"args": [
"-y",
"@openly-useful/linear-project-mcp-server"
],
"command": "npx"
}
}
}
This one needs environment variables set before it will start:
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 (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.).
The author declared them in the registry entry; get the values from the project itself.
Discover, enrich, and rank GitHub repos for an objective with weighted, evidence-based scoring.
Find lab-report identities and clinical research with dated sources and evidence limitations.
Safely manage repository-scoped issues across Linear, GitHub Issues, and Jira Cloud.
Read-only repo navigation and progressive disclosure; BM25 locator with registered evidence.
Transactional refactoring extension with 11 evidence-backed tools, previews, and rollback.
Transactional refactoring extension with 11 evidence-backed tools, previews, and rollback.
Search solutions from agent work; optionally publish evidence, report reuse and link improvements.
A cited wiki of your GitHub repo: search, read pages, find symbols and ask, with line citations.
Answers built from our own checks of this server.