mgraphctl 0.1.0__tar.gz

mgraphctl-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sviatoslav Sviridov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mgraphctl-0.1.0/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.4
+Name: mgraphctl
+Version: 0.1.0
+Summary: Microsoft Graph CLI behind the mgraphctl Claude Code skill
+Keywords: microsoft-graph,microsoft-365,outlook,teams,sharepoint,onedrive,cli
+Author: Sviatoslav Sviridov
+Author-email: Sviatoslav Sviridov <sviridov@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Email
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Utilities
+Requires-Dist: msal>=1.38,<2
+Requires-Dist: httpx>=0.28,<1
+Requires-Dist: typer>=0.27,<1
+Requires-Dist: markdownify>=1.2,<2
+Requires-Dist: keyring>=24,<26
+Requires-Dist: tzdata ; sys_platform == 'win32'
+Requires-Python: >=3.11, <3.14
+Project-URL: Homepage, https://github.com/svd/mgraphctl
+Project-URL: Source, https://github.com/svd/mgraphctl
+Project-URL: Changelog, https://github.com/svd/mgraphctl/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/svd/mgraphctl/issues
+Description-Content-Type: text/markdown
+
+# mgraphctl
+
+Microsoft 365 access from Claude Code through the Microsoft Graph API: Outlook mail and
+calendar, Teams chats and channel messages, presence, meetings and transcripts, SharePoint,
+OneDrive, OneNote, Planner, Microsoft To Do, AI meeting insights, contacts, and the org chart.
+
+The plugin ships a single skill, `mgraphctl`. It is a Python re-implementation of the `msgraph`
+skill, run with `uv`, with a noun-verb command line (`mail list`, `calendar create`, `chats dm`,
+…) instead of Node's flag-driven modes. It is an original design for this repository — not a
+port of, and not tracking, any upstream project — and it extends the Node skill's coverage with
+mail triage, mailbox settings and automatic replies, scheduling (`getSchedule`,
+`findMeetingTimes`), find-or-create Teams DMs, presence, SharePoint lists and uploads, OneDrive
+writes and sharing links, a unified `search` command, and a raw `api` escape hatch. Every write
+verb supports `--dry-run`, and no data command ever opens a browser.
+
+## Install
+
+```bash
+claude plugin marketplace add svd/mgraphctl
+claude plugin install mgraphctl@mgraphctl
+```
+
+The CLI is also on PyPI for use outside Claude Code, under the same version as the plugin:
+
+```bash
+uv tool install mgraphctl      # or: pipx install mgraphctl / uvx mgraphctl status
+mgraphctl status
+```
+
+## Prerequisite: uv
+
+The only prerequisite is [`uv`](https://docs.astral.sh/uv/). On first use in a given environment,
+the plugin's shim script creates a Python virtual environment and installs the CLI's dependencies
+automatically — this takes about 10-40 seconds once; every run after that starts immediately.
+Nothing else needs to be installed by hand.
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh          # macOS / Linux
+brew install uv                                            # macOS, via Homebrew
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"   # Windows
+```
+
+## First run and login
+
+mgraphctl signs in as an Entra application of your own; there is no shared one. Before the
+first login, register a public-client application in your tenant (or ask an administrator for
+the id of one) and tell mgraphctl its client id, once:
+
+```bash
+${CLAUDE_PLUGIN_ROOT}/mgraphctl config set client_id <application (client) id>
+```
+
+`MGRAPHCTL_CLIENT_ID` in the environment works too. Until one is set, `login` and `status` stop
+with `error[CONFIG]: client_id is not set` rather than an Entra error.
+
+Check status first — it never opens a browser and always says what to do next:
+
+```bash
+${CLAUDE_PLUGIN_ROOT}/mgraphctl status
+```
+
+Signing in is interactive, so run it yourself in your own terminal rather than asking Claude to
+run it for you:
+
+```bash
+${CLAUDE_PLUGIN_ROOT}/mgraphctl login
+```
+
+By default `login` opens your system browser for a Microsoft sign-in page. On a host with no
+browser (for example over SSH), use the device-code flow instead, which prints a URL and a code
+to enter on another device:
+
+```bash
+${CLAUDE_PLUGIN_ROOT}/mgraphctl login --device-code
+```
+
+On Windows, or wherever the bash shim cannot run, invoke `uv` directly:
+
+```bat
+set UV_PROJECT_ENVIRONMENT=%LOCALAPPDATA%\mgraphctl\venv
+uv run --project <plugin> --frozen --no-dev mgraphctl login
+```
+
+Every other command reads the cached sign-in silently and never opens a browser or a device-code
+prompt — a missing or expired token fails with an actionable hint instead.
+
+## Where things live
+
+- Virtual environment: under `${CLAUDE_PLUGIN_DATA}` when Claude Code sets it, otherwise
+  `~/.cache/mgraphctl/venv` (`$XDG_CACHE_HOME/mgraphctl/venv` when that variable is set).
+  Persistent across plugin updates; safe to delete, it is rebuilt on the next run.
+- Token cache: the OS keychain (macOS Keychain, Windows Credential Locker, Linux Secret
+  Service) when one is available, as a single `mgraphctl` item whose account is the cache path.
+  Without one it is `~/.mgraphctl/token_cache.json`, mode `0600`, in a `0700` directory.
+  `token_store = auto | keyring | file` in the config file, or `MGRAPHCTL_TOKEN_STORE`, picks;
+  `status` shows which store is in use. A cache file left by an earlier version is imported into
+  the keychain on the first run and then deleted. When the keychain refuses (locked, denied,
+  no session bus), the file takes over for that run with one warning on stderr. On macOS a
+  rebuilt Python (a new venv, a `uv` upgrade) asks once for keychain access; answer
+  "Always Allow". `token_store = "file"` restores the old behaviour.
+- Config file: `~/.mgraphctl/config.toml`, optional (`--config PATH` or `MGRAPHCTL_CONFIG` to
+  point elsewhere). Every `MGRAPHCTL_*` setting can go there as the name without the prefix,
+  lower-cased; a flag beats an environment variable, which beats the file. `mgraphctl config init`
+  writes a commented template, `mgraphctl config set tz Europe/Warsaw` edits one key, and
+  `mgraphctl config show` prints where each value came from.
+
+  ```toml
+  tenant_id = "contoso.onmicrosoft.com"
+  scopes    = "extended"
+  tz        = "Europe/Warsaw"
+  ```
+
+## Scopes
+
+Two named scope sets cover almost everything:
+
+- `default` — the 23 scopes the Node `msgraph` skill has always requested: mail read/send,
+  calendars, files, sites, chats, channel messages, meeting transcripts, people, contacts, notes,
+  tasks, and group membership. This is what `login` requests unless told otherwise.
+- `extended` — `default` plus write access to mail and mailbox settings, presence, directory
+  user lookup, shared calendars, chat creation, and team/channel listing. Request it with
+  `login --scopes extended`; running it again on an already-consented account adds the new scopes
+  with one more consent prompt, no re-login needed.
+
+A handful of scopes are on-demand only, requested with `--scope <name>` on the command that needs
+them (`meetings recordings`, `org manager|reports|chain` for another user, `presence get USER`) —
+they are never in `default` or `extended`.
+
+Some tenants require an administrator to grant consent once for the app registration. If a
+command fails with `error[CONSENT_REQUIRED]`, the error prints the admin-consent URL to send to
+your Microsoft 365 administrator:
+
+```
+https://login.microsoftonline.com/<tenant>/adminconsent?client_id=<client id>
+```
+
+## Differences from `msgraph`
+
+What differs from the Node `msgraph` skill:
+
+- Commands are noun-verb (`mail list`, `calendar create`, `chats send`) instead of Node's
+  flag-driven modes (`--emails`, `--calendar --create`, `--send`).
+- `mail list` defaults to the Inbox; `msgraph`'s `emails` mode listed the whole mailbox. Pass
+  `--folder all` for the old behaviour.
+- Exit codes differ: this CLI uses 0 (success), 1 (runtime error), 2 (usage error), 3 (auth or
+  permission problem), 4 (not found) — `msgraph` was less consistent, including exiting 0 when
+  not logged in.
+
+## Troubleshooting
+
+- **`mgraphctl: 'uv' is not installed`** — install `uv` (see **Prerequisite** above) and try
+  again.
+- **First run is slow** — the shim is building the virtual environment (10-40 seconds); it prints
+  a notice to stderr while doing so, and every later run is fast.
+- **`error[CONSENT_REQUIRED]`** — an administrator must grant consent once; the error prints the
+  admin-consent URL (see **Scopes** above).
+- **`error[NOT_LOGGED_IN]`** — run `login` yourself in your own terminal; data commands never open
+  a browser on their own.
+- **`error[MISSING_SCOPE]`** — the cached sign-in doesn't cover this command; run
+  `login --scopes extended`, or `login --scope <name>` for an on-demand scope.
+- **`claims` exits 3 on a stale or missing cache** — it decodes the cached token locally and never
+  makes a network call, so it cannot refresh an expired token; run `login` (or `status`, which
+  does refresh silently) first.
+- **Device-code login is blocked** — some tenants apply Conditional Access policies that require
+  a compliant, registered device; the device-code flow cannot satisfy those and interactive
+  browser login is the only option.
+- **Behind a proxy** — set `HTTPS_PROXY` (and `HTTP_PROXY` if needed); the CLI honours the
+  standard proxy environment variables.
+- **Times look wrong** — the CLI detects your local IANA time zone automatically; override it with
+  `MGRAPHCTL_TZ=Europe/Warsaw` or the global `--tz` option if detection picks the wrong zone.
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv run ruff check src tests
+uv run ruff format src tests
+```
+
+The test suite runs entirely offline against recorded fixtures — no Microsoft 365 account or
+network access is needed to run it.
+
+CI (`.github/workflows/ci.yml`) runs the suite on Python 3.11–3.13, ruff, `uv lock --check` and a
+credential scan on every push. Releases are annotated `mgraphctl--vX.Y.Z` tags on `main`, cut with
+`claude plugin tag`; the tag publishes the package to PyPI and a GitHub Release. See `VERSIONING.md`.
+
+## Provenance and licence
+
+`mgraphctl` is original to this repository: an independent Python re-implementation of the
+`msgraph` skill's feature set, not a port and not tracking any upstream project. Licensed under
+the MIT licence; see `LICENSE`.

mgraphctl-0.1.0/README.md

@@ -0,0 +1,192 @@
+# mgraphctl
+
+Microsoft 365 access from Claude Code through the Microsoft Graph API: Outlook mail and
+calendar, Teams chats and channel messages, presence, meetings and transcripts, SharePoint,
+OneDrive, OneNote, Planner, Microsoft To Do, AI meeting insights, contacts, and the org chart.
+
+The plugin ships a single skill, `mgraphctl`. It is a Python re-implementation of the `msgraph`
+skill, run with `uv`, with a noun-verb command line (`mail list`, `calendar create`, `chats dm`,
+…) instead of Node's flag-driven modes. It is an original design for this repository — not a
+port of, and not tracking, any upstream project — and it extends the Node skill's coverage with
+mail triage, mailbox settings and automatic replies, scheduling (`getSchedule`,
+`findMeetingTimes`), find-or-create Teams DMs, presence, SharePoint lists and uploads, OneDrive
+writes and sharing links, a unified `search` command, and a raw `api` escape hatch. Every write
+verb supports `--dry-run`, and no data command ever opens a browser.
+
+## Install
+
+```bash
+claude plugin marketplace add svd/mgraphctl
+claude plugin install mgraphctl@mgraphctl
+```
+
+The CLI is also on PyPI for use outside Claude Code, under the same version as the plugin:
+
+```bash
+uv tool install mgraphctl      # or: pipx install mgraphctl / uvx mgraphctl status
+mgraphctl status
+```
+
+## Prerequisite: uv
+
+The only prerequisite is [`uv`](https://docs.astral.sh/uv/). On first use in a given environment,
+the plugin's shim script creates a Python virtual environment and installs the CLI's dependencies
+automatically — this takes about 10-40 seconds once; every run after that starts immediately.
+Nothing else needs to be installed by hand.
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh          # macOS / Linux
+brew install uv                                            # macOS, via Homebrew
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"   # Windows
+```
+
+## First run and login
+
+mgraphctl signs in as an Entra application of your own; there is no shared one. Before the
+first login, register a public-client application in your tenant (or ask an administrator for
+the id of one) and tell mgraphctl its client id, once:
+
+```bash
+${CLAUDE_PLUGIN_ROOT}/mgraphctl config set client_id <application (client) id>
+```
+
+`MGRAPHCTL_CLIENT_ID` in the environment works too. Until one is set, `login` and `status` stop
+with `error[CONFIG]: client_id is not set` rather than an Entra error.
+
+Check status first — it never opens a browser and always says what to do next:
+
+```bash
+${CLAUDE_PLUGIN_ROOT}/mgraphctl status
+```
+
+Signing in is interactive, so run it yourself in your own terminal rather than asking Claude to
+run it for you:
+
+```bash
+${CLAUDE_PLUGIN_ROOT}/mgraphctl login
+```
+
+By default `login` opens your system browser for a Microsoft sign-in page. On a host with no
+browser (for example over SSH), use the device-code flow instead, which prints a URL and a code
+to enter on another device:
+
+```bash
+${CLAUDE_PLUGIN_ROOT}/mgraphctl login --device-code
+```
+
+On Windows, or wherever the bash shim cannot run, invoke `uv` directly:
+
+```bat
+set UV_PROJECT_ENVIRONMENT=%LOCALAPPDATA%\mgraphctl\venv
+uv run --project <plugin> --frozen --no-dev mgraphctl login
+```
+
+Every other command reads the cached sign-in silently and never opens a browser or a device-code
+prompt — a missing or expired token fails with an actionable hint instead.
+
+## Where things live
+
+- Virtual environment: under `${CLAUDE_PLUGIN_DATA}` when Claude Code sets it, otherwise
+  `~/.cache/mgraphctl/venv` (`$XDG_CACHE_HOME/mgraphctl/venv` when that variable is set).
+  Persistent across plugin updates; safe to delete, it is rebuilt on the next run.
+- Token cache: the OS keychain (macOS Keychain, Windows Credential Locker, Linux Secret
+  Service) when one is available, as a single `mgraphctl` item whose account is the cache path.
+  Without one it is `~/.mgraphctl/token_cache.json`, mode `0600`, in a `0700` directory.
+  `token_store = auto | keyring | file` in the config file, or `MGRAPHCTL_TOKEN_STORE`, picks;
+  `status` shows which store is in use. A cache file left by an earlier version is imported into
+  the keychain on the first run and then deleted. When the keychain refuses (locked, denied,
+  no session bus), the file takes over for that run with one warning on stderr. On macOS a
+  rebuilt Python (a new venv, a `uv` upgrade) asks once for keychain access; answer
+  "Always Allow". `token_store = "file"` restores the old behaviour.
+- Config file: `~/.mgraphctl/config.toml`, optional (`--config PATH` or `MGRAPHCTL_CONFIG` to
+  point elsewhere). Every `MGRAPHCTL_*` setting can go there as the name without the prefix,
+  lower-cased; a flag beats an environment variable, which beats the file. `mgraphctl config init`
+  writes a commented template, `mgraphctl config set tz Europe/Warsaw` edits one key, and
+  `mgraphctl config show` prints where each value came from.
+
+  ```toml
+  tenant_id = "contoso.onmicrosoft.com"
+  scopes    = "extended"
+  tz        = "Europe/Warsaw"
+  ```
+
+## Scopes
+
+Two named scope sets cover almost everything:
+
+- `default` — the 23 scopes the Node `msgraph` skill has always requested: mail read/send,
+  calendars, files, sites, chats, channel messages, meeting transcripts, people, contacts, notes,
+  tasks, and group membership. This is what `login` requests unless told otherwise.
+- `extended` — `default` plus write access to mail and mailbox settings, presence, directory
+  user lookup, shared calendars, chat creation, and team/channel listing. Request it with
+  `login --scopes extended`; running it again on an already-consented account adds the new scopes
+  with one more consent prompt, no re-login needed.
+
+A handful of scopes are on-demand only, requested with `--scope <name>` on the command that needs
+them (`meetings recordings`, `org manager|reports|chain` for another user, `presence get USER`) —
+they are never in `default` or `extended`.
+
+Some tenants require an administrator to grant consent once for the app registration. If a
+command fails with `error[CONSENT_REQUIRED]`, the error prints the admin-consent URL to send to
+your Microsoft 365 administrator:
+
+```
+https://login.microsoftonline.com/<tenant>/adminconsent?client_id=<client id>
+```
+
+## Differences from `msgraph`
+
+What differs from the Node `msgraph` skill:
+
+- Commands are noun-verb (`mail list`, `calendar create`, `chats send`) instead of Node's
+  flag-driven modes (`--emails`, `--calendar --create`, `--send`).
+- `mail list` defaults to the Inbox; `msgraph`'s `emails` mode listed the whole mailbox. Pass
+  `--folder all` for the old behaviour.
+- Exit codes differ: this CLI uses 0 (success), 1 (runtime error), 2 (usage error), 3 (auth or
+  permission problem), 4 (not found) — `msgraph` was less consistent, including exiting 0 when
+  not logged in.
+
+## Troubleshooting
+
+- **`mgraphctl: 'uv' is not installed`** — install `uv` (see **Prerequisite** above) and try
+  again.
+- **First run is slow** — the shim is building the virtual environment (10-40 seconds); it prints
+  a notice to stderr while doing so, and every later run is fast.
+- **`error[CONSENT_REQUIRED]`** — an administrator must grant consent once; the error prints the
+  admin-consent URL (see **Scopes** above).
+- **`error[NOT_LOGGED_IN]`** — run `login` yourself in your own terminal; data commands never open
+  a browser on their own.
+- **`error[MISSING_SCOPE]`** — the cached sign-in doesn't cover this command; run
+  `login --scopes extended`, or `login --scope <name>` for an on-demand scope.
+- **`claims` exits 3 on a stale or missing cache** — it decodes the cached token locally and never
+  makes a network call, so it cannot refresh an expired token; run `login` (or `status`, which
+  does refresh silently) first.
+- **Device-code login is blocked** — some tenants apply Conditional Access policies that require
+  a compliant, registered device; the device-code flow cannot satisfy those and interactive
+  browser login is the only option.
+- **Behind a proxy** — set `HTTPS_PROXY` (and `HTTP_PROXY` if needed); the CLI honours the
+  standard proxy environment variables.
+- **Times look wrong** — the CLI detects your local IANA time zone automatically; override it with
+  `MGRAPHCTL_TZ=Europe/Warsaw` or the global `--tz` option if detection picks the wrong zone.
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv run ruff check src tests
+uv run ruff format src tests
+```
+
+The test suite runs entirely offline against recorded fixtures — no Microsoft 365 account or
+network access is needed to run it.
+
+CI (`.github/workflows/ci.yml`) runs the suite on Python 3.11–3.13, ruff, `uv lock --check` and a
+credential scan on every push. Releases are annotated `mgraphctl--vX.Y.Z` tags on `main`, cut with
+`claude plugin tag`; the tag publishes the package to PyPI and a GitHub Release. See `VERSIONING.md`.
+
+## Provenance and licence
+
+`mgraphctl` is original to this repository: an independent Python re-implementation of the
+`msgraph` skill's feature set, not a port and not tracking any upstream project. Licensed under
+the MIT licence; see `LICENSE`.

mgraphctl-0.1.0/pyproject.toml

@@ -0,0 +1,98 @@
+[project]
+name = "mgraphctl"
+version = "0.1.0"
+description = "Microsoft Graph CLI behind the mgraphctl Claude Code skill"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11,<3.14"
+keywords = [
+    "microsoft-graph",
+    "microsoft-365",
+    "outlook",
+    "teams",
+    "sharepoint",
+    "onedrive",
+    "cli",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Communications :: Email",
+    "Topic :: Office/Business",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "msal>=1.38,<2",
+    "httpx>=0.28,<1",
+    "typer>=0.27,<1",
+    "markdownify>=1.2,<2",
+    "keyring>=24,<26",
+    "tzdata; sys_platform == 'win32'",
+]
+
+[[project.authors]]
+name = "Sviatoslav Sviridov"
+email = "sviridov@gmail.com"
+
+[project.urls]
+Homepage = "https://github.com/svd/mgraphctl"
+Source = "https://github.com/svd/mgraphctl"
+Changelog = "https://github.com/svd/mgraphctl/blob/main/CHANGELOG.md"
+Issues = "https://github.com/svd/mgraphctl/issues"
+
+[project.scripts]
+mgraphctl = "mgraphctl.cli:main"
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "respx>=0.23",
+    "ruff>=0.13",
+]
+
+[build-system]
+requires = ["uv_build>=0.8,<1"]
+build-backend = "uv_build"
+
+[tool.uv]
+exclude-newer = "2026-09-01T00:00:00Z"
+
+[tool.uv.build-backend]
+module-name = "mgraphctl"
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+extend-exclude = ["docs"]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "UP",
+    "B",
+    "SIM",
+]
+
+[tool.ruff.lint.isort]
+known-first-party = [
+    "mgraphctl",
+    "helpers",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+markers = [
+    "real_auth: module tests auth itself; do not install the fake token provider",
+    "scopes(list): scopes carried by the synthetic token for this test",
+]

mgraphctl-0.1.0/pyproject.toml.orig

@@ -0,0 +1,74 @@
+[project]
+name = "mgraphctl"
+version = "0.1.0"
+description = "Microsoft Graph CLI behind the mgraphctl Claude Code skill"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Sviatoslav Sviridov", email = "sviridov@gmail.com" }]
+requires-python = ">=3.11,<3.14"
+keywords = ["microsoft-graph", "microsoft-365", "outlook", "teams", "sharepoint", "onedrive", "cli"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Intended Audience :: End Users/Desktop",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Communications :: Email",
+  "Topic :: Office/Business",
+  "Topic :: Utilities",
+]
+dependencies = [
+  "msal>=1.38,<2",
+  "httpx>=0.28,<1",
+  "typer>=0.27,<1",
+  "markdownify>=1.2,<2",
+  "keyring>=24,<26",
+  "tzdata; sys_platform == 'win32'",
+]
+
+[project.urls]
+Homepage = "https://github.com/svd/mgraphctl"
+Source = "https://github.com/svd/mgraphctl"
+Changelog = "https://github.com/svd/mgraphctl/blob/main/CHANGELOG.md"
+Issues = "https://github.com/svd/mgraphctl/issues"
+
+[project.scripts]
+mgraphctl = "mgraphctl.cli:main"
+
+[dependency-groups]
+dev = ["pytest>=8", "respx>=0.23", "ruff>=0.13"]
+
+[build-system]
+requires = ["uv_build>=0.8,<1"]
+build-backend = "uv_build"
+
+[tool.uv]
+exclude-newer = "2026-09-01T00:00:00Z"
+
+[tool.uv.build-backend]
+module-name = "mgraphctl"
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+# Markdown under docs/ holds illustrative Python blocks; ruff must not rewrite them.
+extend-exclude = ["docs"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["mgraphctl", "helpers"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+markers = [
+  "real_auth: module tests auth itself; do not install the fake token provider",
+  "scopes(list): scopes carried by the synthetic token for this test",
+]

mgraphctl-0.1.0/src/mgraphctl/__init__.py

@@ -0,0 +1,3 @@
+"""mgraphctl: Microsoft Graph CLI for the mgraphctl skill."""
+
+__version__ = "0.1.0"

mgraphctl-0.1.0/src/mgraphctl/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+main()