# okffs MCP server

> Enables Claude Code to manage the entire GitHub workflow from creating issues and branches to opening pull requests and handling reviews.

- Repository: https://github.com/neturely/okffs
- Page: https://hostedmcp.org/servers/neturely/okffs
- Transport: stdio
- Stars: 2
- License: MIT
- Latest version: 0.15.0

## Install

### Claude Code

```sh
claude mcp add --env 'GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>' okffs -- npx -y @neturely/okffs
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "okffs": {
      "command": "npx",
      "args": [
        "-y",
        "@neturely/okffs"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "okffs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@neturely/okffs"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"okffs","type":"stdio","command":"npx","args":["-y","@neturely/okffs"],"env":{"GITHUB_TOKEN":"<YOUR_GITHUB_TOKEN>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "okffs": {
      "command": "npx",
      "args": [
        "-y",
        "@neturely/okffs"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add okffs --env 'GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>' -- npx -y @neturely/okffs
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.okffs]
command = "npx"
args = ["-y", "@neturely/okffs"]

[mcp_servers.okffs.env]
GITHUB_TOKEN = "<YOUR_GITHUB_TOKEN>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'GITHUB_TOKEN=<YOUR_GITHUB_TOKEN>' okffs npx -- -y @neturely/okffs
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "okffs": {
      "command": "npx",
      "args": [
        "-y",
        "@neturely/okffs"
      ],
      "env": {
        "GITHUB_TOKEN": "<YOUR_GITHUB_TOKEN>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GITHUB_TOKEN` | no | yes | GitHub PAT (fine-grained recommended). Falls back to `gh auth token` if unset. |
| `GITHUB_OWNER` | no | no | Target repo owner. Auto-detected from the git origin remote if unset. |
| `GITHUB_REPO` | no | no | Target repo name. Auto-detected from the git origin remote if unset. |
| `OKFFS_PROJECT_ENABLED` | no | no |  |
| `OKFFS_PROJECT_ID` | no | no |  |

## Tools (24)

- `create_issue`
- `create_issues_from_list`
- `plan`
- `list_issues`
- `get_issue`
- `comment_issue`
- `link_issues`
- `close_issue`
- `create_pull_request`
- `commit_and_update`
- `merge_pull_request`
- `get_pr_checks`
- `fix_into_base`
- `promote_branch`
- `list_pr_review_comments`
- `reply_to_review_comment`
- `resolve_review_thread`
- `prepare_release`
- `update_project_status`
- `set_issue_fields`
- `update_issue`
- `configure`
- `delete_issue`
- `delete_branch`

## FAQ

### Does okffs require complex configuration?

No, it requires little to no configuration. If you are already signed in with the GitHub CLI (gh) inside your repo, it works with no config at all.

### What is Autopilot mode?

Autopilot mode allows Claude to make recommended decisions for reversible actions to reduce confirmation friction, driving an issue all the way to a PR.
