Okffs MCP Server

Turn a conversation with Claude into GitHub issues, branches, and pull requests - without leaving Claude Code. Its 23 documented tools cover issue, issues, review, comment. It runs locally over stdio via the published package.

People who work with issue, issues and review and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-18 · ★ 2 · #87 OF 227 MAINTAINED AUTOMATION · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Okffs

before you install - you'll need

Set OKFFS_PROJECT_ENABLED, OKFFS_PROJECT_ID, GITHUB_TOKEN, GITHUB_OWNER, GITHUB_REPO before connecting.

Claude Code

claude mcp add neturely-okffs -- npx -y @neturely/okffs

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "neturely-okffs": {
      "command": "npx",
      "args": [
        "-y",
        "@neturely/okffs"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @neturely/okffs - published under the repo owner's npm scope (@neturely)

registry namespace io.github.neturely is GitHub-verified and matches the repo owner

03 · What Okffs can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create many issues + branches from a task list in one shot. Confirms first. Per-task labels, assignees, milestone, priority, effort, type, post a comment - handy for logging what a branch did, close an issue and tips you to /clear before the next one, and fetch a PR's inline review threads and summaries.

Capability map

Tools grouped from the project's README - what Okffs lets an agent do.

Issue

7 tools - e.g. Creates an issue and a matching branch (an Epic gets no branch or draft PR - work lands on its children). Infers labels, a board priority/effort, and a native I; Full details for one issue: title, body…

create_issue · get_issue · comment_issue · close_issue · set_issue_fields · update_issue…

Issues

3 tools - e.g. Creates many issues + branches from a task list in one shot. Confirms first. Per-task labels, assignees, milestone, priority, effort, type.; Lists open issues with branch, linked PR, board column…

create_issues_from_list · list_issues · link_issues

Plan

1 tool - e.g. Give it a free-text description plus the breakdown Claude generates (titles, descriptions, labels, priority/effort/type, relationships); it creates every issue

plan

create & write

1 tool - e.g. Opens a PR for an issue branch - generates the title/body, pushes the branch, always includes Closes N, and comments back. Can write changelog fragments when O

create_pull_request

Commit

1 tool - e.g. Stages tracked changes (untracked need include_untracked: true), commits (your message verbatim, or an auto-generated one), pushes, and posts a progress comment

commit_and_update

Merge

1 tool - e.g. Autonomously merges a green, review-resolved issue PR into the base branch (e.g. develop) using OKFFS_BASE_MERGE_METHOD, then closes the issue. Opt-in (OKFFS_AU

merge_pull_request

Fix

1 tool - e.g. Opens (and, under the same OKFFS_AUTO_MERGE_BASE gates, merges) an issue-less fix PR into the base branch - for small cleanups such as review-comment fixes. Nev

fix_into_base

Promote

1 tool - e.g. Opens the issue-less promotion PR (e.g. develop → main), boards it, optionally requests reviewers, and lists the releases it carries per app. A re-run reports u

promote_branch

Latest releases

v0.12.0 · 2026-08-21

Added · Promotion-PR review feedback is surfaced proactively: re-running promote_branch on an existing gate PR reports its unresolved review threads (count + reviewers + the address_pr_review loop to run) without…

v0.11.0 · 2026-08-12

Security · commit_and_update no longer silently sweeps untracked files into commits: staging defaults to tracked-modified only (git add -u), untracked files require include_untracked: true, a secrets deny-list (.env…

v0.10.2 · 2026-08-11

Changed · update_project_status: rename issue param to issue_number for cross-tool consistency (issue stays as a deprecated alias for one release) (#278) · Fixed · Stale owner after repo transfer: head= filter silently…

04 · Who maintains Okffs

okffs is maintained by neturely. It's the only MCP server we track from this author; the repo dates to May 2026.

05 · Facts

category
automation - ranked #87 of 227 actively-maintained automation servers as of 2026-09-18.
release cadence
10+ releases in the last 90 days (latest 2026-08-21)
registry
io.github.neturely/okffs (active, first published 2026-06-30 · 15 versions)
packages
npm:@neturely/okffs

06 · Okffs FAQ

Is Okffs still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-18 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Okffs do?

With this server connected, an agent can create many issues + branches from a task list in one shot. Confirms first. Per-task labels, assignees, milestone, priority, effort, type, post a comment - handy for logging what a branch did, close an issue and tips you to /clear before the next one, and fetch a PR's inline review threads and summaries.

How do I install Okffs?

Run `npx -y @neturely/okffs`. The README documents 5 environment variables (OKFFS_PROJECT_ENABLED, OKFFS_PROJECT_ID, GITHUB_TOKEN…) to set first. Set OKFFS_PROJECT_ENABLED, OKFFS_PROJECT_ID, GITHUB_TOKEN, GITHUB_OWNER, GITHUB_REPO before connecting. You can also paste the ready-made client config above.

Does Okffs run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Okffs