Linear Project MCP server

by openlyuseful.org·org.openlyuseful/linear-project·v0.1.0

No reviews yet

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

B72/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B72/100

full report

Adoption

New

0 stars36 downloads/wk

Reviews

Write one

Nobody has reviewed Linear Project yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Linear Project tools (13, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

github_get_project_evidence
Read and normalize one allowlisted GitHub repository, commit, pull request, or issue as canonical project evidence. GitHub access is always read-only.
linear_project_bootstrapwrite action
Create or reuse the exact team, project, ACQI-style issue label, and matching project label. Supports an existing team, a dedicated key-bearing team, or a key-bearing subteam. Optionally verifies and links an allowlisted GitHub repository and Obsidian project note, then creates an idempotent first issue with immediate readback.
linear_project_capabilities
Report configured Linear, GitHub, and Obsidian adapters, exact allowlist coverage, workspace reachability, team-admin support, and whether mutations are enabled. Never writes.
linear_project_create_teamwrite action
Idempotently create a dedicated Linear team whose key exactly equals an allowlisted scope code. Optionally create it as a subteam of an allowlisted parent. Verifies empty issue history on new teams so CODE-1 can be attempted safely.
linear_project_find_candidates
Search for potentially related Linear issues, discard results from non-allowlisted teams, and classify whether each candidate is already in the destination project, carries the scope label, or is historical. Never moves or mutates issues.
linear_project_link_evidence
Verify an allowlisted GitHub reference or allowlisted Obsidian note, confirm the destination issue is inside the exact project and carries the scope label, then add an idempotent evidence link. Does not copy Obsidian note contents into Linear.
linear_project_list_scoped_issues
List issues only when they belong to the exact allowlisted Linear project and carry its exact scope-code issue label. Supports cursor pagination and never writes.
linear_project_move_candidate
Move one previously reviewed, allowlisted issue into the exact destination project and apply its scope label. Same-team moves preserve the issue identifier and existing labels. Cross-team moves replace source-team labels and require explicit acknowledgement that the identifier changes. Never changes status or completion.
linear_project_resolve_scope
Resolve one allowlisted team, project, issue label, and project label by exact IDs or exact names. Fails on ambiguity and never mutates Linear.
linear_project_upsert_scoped_issuewrite action
Create or update exactly one issue inside an allowlisted team and project using a deterministic source marker. Always applies the scope label. Historical records receive the exact [HISTORICAL] title prefix, a HISTORICAL label, and non-actionability metadata.
obsidian_read_project_note
Read one size-limited Markdown note by safe vault-relative path inside the configured Obsidian directory allowlist. Never writes.
obsidian_search_project_notes
Search Markdown notes only inside configured Obsidian directories. Symlinks, traversal, oversized files, and non-Markdown files are excluded. Never writes.
obsidian_upsert_project_notewrite action
Create or replace only the Openly Useful managed section of an allowlisted Obsidian Markdown note. Preserves all content outside the marker block and requires global writes to be enabled.

Public scan report

scanner v0.1.10 · 2026-11-01 · same rubric, same numbers if you re-run it

no findings

Code scan24 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 70 days ago12/15
Maintainer identitynamespace and repository owner differ4/10

Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Linear Project compares

Against every graded Developer tools MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 72/100; higher than 33% of 1,119 Developer tools servers
Tools: 13; the typical Developer tools server has 7
Tools that change things: 31%; typical: 5%. Fewer write tools means less an agent can break
Downloads a week: 36; more than 22% of 436 Developer tools servers with a package

What its tools let an agent do: 9 read · 4 change

Install Linear Project in Claude Code, Cursor or VS Code

Runs npx -y @openly-useful/linear-project-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add linear-project -- npx -y @openly-useful/linear-project-mcp-server

Add to Cursor

What the publisher says

From the Linear Project repository's README, as published. We do not edit it. Read it on GitHub

Linear Project Skills

Three interoperable Agent Skills and an optional MCP server for creating, maintaining, and reconciling Linear projects without pulling unrelated work into scope.

This collection is an Openly Useful project: practical infrastructure people can inspect, adapt, and improve.

Openly Useful LLC is the planned legal entity and remains formation-pending. Openly Useful is currently operated by its founder as an individual, and this repository does not claim that the LLC is formed, active, or the current operator. publisher.json is a repo-local projection of the public publisher authority. The founder-owner has authorized external source and registry publication while formation proceeds; namespace verification, provider authentication, and provider review remain provider-specific steps.

Included skills

The skills hand work to one another rather than duplicating responsibilities:

new project ──> bootstrap ──> sync
                    ▲
                    │ no canonical project
existing work ─> reconcile ──> sync

Optional MCP server

@openly-useful/linear-project-mcp-server turns the workflows into 13 typed MCP tools. It can create a dedicated Linear team or subteam, bootstrap a scope-labeled project, capture active or [HISTORICAL] issues idempotently, find and explicitly move reviewed reconciliation candidates, and link verified evidence.

The server calls Linear directly through its official TypeScript SDK. GitHub evidence is optional and read-only. Obsidian support is optional, local, restricted to allowlisted Markdown directories, and never copies note contents into Linear when adding a link.

All mutations are disabled by default and require an exact organization allowlist, a scope-code allowlist, team/project gates, and a literal per-tool confirmation. See the server setup and security guide for installation and client configuration.

The MCP integration has four intentionally distinct names:

For a source checkout, build the package and register the local executable with Codex:

cd mcp/linear-project-mcp-server
pnpm install --frozen-lockfile
pnpm build
MCP_ENTRYPOINT="$(pwd)/dist/index.js"
codex mcp add linear_project -- node "$MCP_ENTRYPOINT"
codex mcp get linear_project --json
codex mcp list --json

These commands contain no credentials. Supply adapter credentials through a protected launcher or secret store rather than command arguments or committed client configuration. See the MCP client guide for the npm command that applies after the first release and for the expected read-only acceptance checks.

The key rule

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Linear Project: common questions

Is Linear Project MCP server safe?: Mostly: it is graded B (72/100). Read the Linear Project safety report
How do I install Linear Project?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Linear Project need an API key?: Yes. The registry entry asks for LINEAR_API_KEY, LINEAR_ACCESS_TOKEN, GITHUB_TOKEN.
Is Linear Project maintained?: The last commit was 73 days ago (2026-08-23). The latest release is v0.1.0.
What can I use instead of Linear Project?: Servers from other publishers that do the same job: Agentic Task System (ATS) MCP server, GitLab MCP Server and GitDiagram MCP server.
How does Linear Project compare with other Developer tools MCP servers?: safety score 72/100 (higher than 33% of 1,119 Developer tools servers); tools 13 (the typical Developer tools server has 7); tools that change things 31% (typical: 5%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Linear Project

Same job from other publishers: the closest match first, then the best rated.

Agentic Task System (ATS)
Persistent task context across TickTick, Notion, GitHub, Obsidian, Taskmaster and Beads
not reviewed
Growing
A
GitLab MCP Server
GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more.
not reviewed
Widely used
B
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
not reviewed
Established
A
GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
not reviewed
Established
A
Gk CLI
The GitKraken MCP Server for managing repos, PRs, issues across GitHub, GitLab, Bitbucket and more.
not reviewed
Established
B

Run it through the gateway

Local package. It runs on your machine, not through the gateway.

Rating: —
Safety grade: B · 72/100
Stars: 0
Downloads/wk: 36
Price: Free
Licence: MIT
Transport: Local · npm
Version: 0.1.0
Category: Developer tools
Last release: 2026-08-23

Credentials it needs

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_IDExact 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.

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/openlyuseful-linear-project.svg)](https://mcp.market/server/openlyuseful-linear-project)

How the badge works