github-mcp-connector 0.7.0__tar.gz → 0.8.0__tar.gz

{github_mcp_connector-0.7.0/src/github_mcp_connector.egg-info → github_mcp_connector-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-mcp-connector
-Version: 0.7.0
+Version: 0.8.0
 Summary: A Model Context Protocol (MCP) connector for GitHub, for use with Claude.
 Author: winnerlose2026
 License: MIT
@@ -51,7 +51,7 @@ Enterprise Server.
 - 🧾 **Commits** — history, single-commit detail, and diffs between refs
 - 🐛 **Issues** — list, read, create, comment, read comments, edit/close, label, assign
 - 🔀 **Pull requests** — list, read, diffs/files, comments, open, update, merge, and review
-- ⚙️ **Actions & releases** — list runs/jobs, read failed-job logs, re-run/dispatch workflows, commit statuses & check runs, list/create releases
+- ⚙️ **Actions & releases** — list runs/jobs, read failed-job logs, re-run/dispatch/**schedule** workflows, commit statuses & check runs, list/create releases
 - 🔐 **Security** — secret-scanning, code-scanning, and Dependabot alerts
 - 🔔 **Notifications** — list and mark read across all your repos
 - ✍️ **Repo writes** — create branches, commit files, manage labels/assignees, create gists (gated by read-only mode)
@@ -101,6 +101,7 @@ Enterprise Server.
 | `add_pull_request_review_comment` | Inline comment on a PR diff line | ✅ |
 | `rerun_workflow_run` | Re-run a workflow run (or just failed jobs) | ✅ |
 | `trigger_workflow` | Dispatch a workflow_dispatch run | ✅ |
+| `create_scheduled_workflow` | Commit a cron-scheduled workflow ("do X later") | ✅ |
 | `create_release` | Create a release (and its tag) | ✅ |
 | `create_issue` | Open a new issue | ✅ |
 | `update_issue` | Edit/close/reopen an issue | ✅ |

{github_mcp_connector-0.7.0 → github_mcp_connector-0.8.0}/README.md

@@ -21,7 +21,7 @@ Enterprise Server.
 - 🧾 **Commits** — history, single-commit detail, and diffs between refs
 - 🐛 **Issues** — list, read, create, comment, read comments, edit/close, label, assign
 - 🔀 **Pull requests** — list, read, diffs/files, comments, open, update, merge, and review
-- ⚙️ **Actions & releases** — list runs/jobs, read failed-job logs, re-run/dispatch workflows, commit statuses & check runs, list/create releases
+- ⚙️ **Actions & releases** — list runs/jobs, read failed-job logs, re-run/dispatch/**schedule** workflows, commit statuses & check runs, list/create releases
 - 🔐 **Security** — secret-scanning, code-scanning, and Dependabot alerts
 - 🔔 **Notifications** — list and mark read across all your repos
 - ✍️ **Repo writes** — create branches, commit files, manage labels/assignees, create gists (gated by read-only mode)
@@ -71,6 +71,7 @@ Enterprise Server.
 | `add_pull_request_review_comment` | Inline comment on a PR diff line | ✅ |
 | `rerun_workflow_run` | Re-run a workflow run (or just failed jobs) | ✅ |
 | `trigger_workflow` | Dispatch a workflow_dispatch run | ✅ |
+| `create_scheduled_workflow` | Commit a cron-scheduled workflow ("do X later") | ✅ |
 | `create_release` | Create a release (and its tag) | ✅ |
 | `create_issue` | Open a new issue | ✅ |
 | `update_issue` | Edit/close/reopen an issue | ✅ |

{github_mcp_connector-0.7.0 → github_mcp_connector-0.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "github-mcp-connector"
-version = "0.7.0"
+version = "0.8.0"
 description = "A Model Context Protocol (MCP) connector for GitHub, for use with Claude."
 readme = "README.md"
 requires-python = ">=3.10"

{github_mcp_connector-0.7.0 → github_mcp_connector-0.8.0}/src/github_mcp/server.py

@@ -12,6 +12,7 @@ variable ``GITHUB_MCP_READ_ONLY`` is truthy.
 from __future__ import annotations
 
 import base64
+import re
 from typing import Any
 from urllib.parse import quote
 
@@ -1628,6 +1629,98 @@ async def create_gist(
     return _summarize_gist(gist)
 
 
+@mcp.tool()
+async def create_scheduled_workflow(
+    owner: str,
+    repo: str,
+    name: str,
+    cron: str,
+    run: str,
+    runs_on: str = "ubuntu-latest",
+    branch: str | None = None,
+    filename: str | None = None,
+    message: str | None = None,
+) -> dict[str, Any]:
+    """Schedule recurring work by committing a cron GitHub Actions workflow.
+
+    This is GitHub's native "do X later / on a schedule": it creates (or updates)
+    a workflow file at `.github/workflows/<filename>` that runs `run` (a shell
+    script) on the `cron` schedule, and also adds a `workflow_dispatch` trigger
+    so you can run it on demand. `cron` is standard 5-field UTC cron
+    (e.g. "0 9 * * 1" = 09:00 UTC every Monday).
+
+    IMPORTANT: GitHub only fires `schedule` triggers from a repository's DEFAULT
+    branch, so `branch` defaults to it — committing to another branch will run on
+    demand but never on the schedule. `filename` defaults to a slug of `name`.
+    Disabled in read-only mode; requires write access (and the token needs the
+    `workflow` scope to add workflow files).
+    """
+    _require_token()
+    _require_write()
+    if len(cron.split()) != 5:
+        raise GitHubError(
+            400,
+            "CRON",
+            f"/repos/{owner}/{repo}",
+            f"`cron` must be a 5-field cron expression (got: {cron!r}).",
+        )
+    slug = re.sub(r"[^a-z0-9]+", "-", name.lower()).strip("-") or "scheduled"
+    fname = filename or f"{slug}.yml"
+    path = f".github/workflows/{fname}"
+    indented_run = "\n".join("          " + line for line in run.splitlines())
+    content = (
+        f"name: {name}\n"
+        "on:\n"
+        "  schedule:\n"
+        f'    - cron: "{cron}"\n'
+        "  workflow_dispatch: {}\n"
+        "permissions:\n"
+        "  contents: read\n"
+        "jobs:\n"
+        "  scheduled:\n"
+        f"    runs-on: {runs_on}\n"
+        "    steps:\n"
+        "      - uses: actions/checkout@v4\n"
+        "      - name: Run scheduled command\n"
+        "        run: |\n"
+        f"{indented_run}\n"
+    )
+    encoded = base64.b64encode(content.encode("utf-8")).decode("ascii")
+    commit_message = message or f"Add scheduled workflow: {name}"
+    async with GitHubClient(config) as gh:
+        if branch is None:
+            repo_data = await gh.get(f"/repos/{owner}/{repo}")
+            branch = repo_data.get("default_branch")
+        payload: dict[str, Any] = {
+            "message": commit_message,
+            "content": encoded,
+            "branch": branch,
+        }
+        # If the workflow file already exists on this branch, update it.
+        try:
+            existing = await gh.get(
+                f"/repos/{owner}/{repo}/contents/{path}", params={"ref": branch}
+            )
+            if isinstance(existing, dict) and existing.get("sha"):
+                payload["sha"] = existing.get("sha")
+        except GitHubError as exc:
+            if exc.status_code != 404:
+                raise
+        result = await gh.put(f"/repos/{owner}/{repo}/contents/{path}", json=payload)
+    commit = result.get("commit", {})
+    content_info = result.get("content", {})
+    return {
+        "path": content_info.get("path", path),
+        "branch": branch,
+        "cron": cron,
+        "runs_on": runs_on,
+        "commit_sha": commit.get("sha"),
+        "html_url": content_info.get("html_url"),
+        "note": "Scheduled runs fire only from the default branch and start "
+        "from the next cron tick; use trigger_workflow to run it now.",
+    }
+
+
 def main(argv: list[str] | None = None) -> None:
     """Console entry point. Selects the transport from CLI args/env."""
     import argparse

{github_mcp_connector-0.7.0 → github_mcp_connector-0.8.0/src/github_mcp_connector.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-mcp-connector
-Version: 0.7.0
+Version: 0.8.0
 Summary: A Model Context Protocol (MCP) connector for GitHub, for use with Claude.
 Author: winnerlose2026
 License: MIT
@@ -51,7 +51,7 @@ Enterprise Server.
 - 🧾 **Commits** — history, single-commit detail, and diffs between refs
 - 🐛 **Issues** — list, read, create, comment, read comments, edit/close, label, assign
 - 🔀 **Pull requests** — list, read, diffs/files, comments, open, update, merge, and review
-- ⚙️ **Actions & releases** — list runs/jobs, read failed-job logs, re-run/dispatch workflows, commit statuses & check runs, list/create releases
+- ⚙️ **Actions & releases** — list runs/jobs, read failed-job logs, re-run/dispatch/**schedule** workflows, commit statuses & check runs, list/create releases
 - 🔐 **Security** — secret-scanning, code-scanning, and Dependabot alerts
 - 🔔 **Notifications** — list and mark read across all your repos
 - ✍️ **Repo writes** — create branches, commit files, manage labels/assignees, create gists (gated by read-only mode)
@@ -101,6 +101,7 @@ Enterprise Server.
 | `add_pull_request_review_comment` | Inline comment on a PR diff line | ✅ |
 | `rerun_workflow_run` | Re-run a workflow run (or just failed jobs) | ✅ |
 | `trigger_workflow` | Dispatch a workflow_dispatch run | ✅ |
+| `create_scheduled_workflow` | Commit a cron-scheduled workflow ("do X later") | ✅ |
 | `create_release` | Create a release (and its tag) | ✅ |
 | `create_issue` | Open a new issue | ✅ |
 | `update_issue` | Edit/close/reopen an issue | ✅ |

{github_mcp_connector-0.7.0 → github_mcp_connector-0.8.0}/tests/test_server.py

@@ -1056,3 +1056,57 @@ async def test_get_repository_tree_errors_without_default_branch(monkeypatch):
     with pytest.raises(GitHubError) as exc:
         await server.get_repository_tree("o", "r")
     assert exc.value.status_code == 404
+
+
+async def test_create_scheduled_workflow_read_only(monkeypatch):
+    install_mock(monkeypatch, lambda r: httpx.Response(200, json={}),
+                 read_only=True)
+    with pytest.raises(GitHubError) as exc:
+        await server.create_scheduled_workflow("o", "r", "Nightly", "0 9 * * *",
+                                               "echo hi")
+    assert exc.value.status_code == 403
+
+
+async def test_create_scheduled_workflow_bad_cron(monkeypatch):
+    install_mock(monkeypatch, lambda r: httpx.Response(200, json={}))
+    with pytest.raises(GitHubError) as exc:
+        await server.create_scheduled_workflow("o", "r", "x", "not cron", "echo")
+    assert exc.value.status_code == 400
+
+
+async def test_create_scheduled_workflow_commits_yaml(monkeypatch):
+    import base64
+    captured = {}
+
+    def handler(request):
+        import json
+        p = request.url.path
+        if request.method == "GET" and p == "/repos/o/r":
+            return httpx.Response(200, json={"default_branch": "main"})
+        if request.method == "GET" and p.startswith("/repos/o/r/contents/"):
+            return httpx.Response(404, json={"message": "Not Found"})
+        if request.method == "PUT" and p == "/repos/o/r/contents/.github/workflows/nightly-backup.yml":
+            captured["body"] = json.loads(request.content)
+            captured["path"] = p
+            return httpx.Response(
+                201,
+                json={"content": {"path": ".github/workflows/nightly-backup.yml",
+                                  "sha": "s", "html_url": "u"},
+                      "commit": {"sha": "c"}},
+            )
+        raise AssertionError(f"unexpected {request.method} {p}")
+
+    install_mock(monkeypatch, handler)
+    result = await server.create_scheduled_workflow(
+        "o", "r", "Nightly Backup", "0 9 * * 1", "echo hi\nrun-backup.sh"
+    )
+    body = captured["body"]
+    assert body["branch"] == "main"  # defaulted to default branch
+    assert "sha" not in body  # new file
+    yaml = base64.b64decode(body["content"]).decode()
+    assert "schedule:" in yaml
+    assert 'cron: "0 9 * * 1"' in yaml
+    assert "workflow_dispatch: {}" in yaml
+    assert "run-backup.sh" in yaml
+    assert result["cron"] == "0 9 * * 1"
+    assert result["branch"] == "main"