msgraph-mcp-server 0.3.2__tar.gz → 0.4.0__tar.gz

{msgraph_mcp_server-0.3.2 → msgraph_mcp_server-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: msgraph-mcp-server
-Version: 0.3.2
+Version: 0.4.0
 Summary: MCP server for Microsoft Graph: Outlook mail and calendar, plus read-only Microsoft Teams
 Project-URL: Homepage, https://github.com/timfurlong/msgraph-mcp
 Project-URL: Repository, https://github.com/timfurlong/msgraph-mcp

{msgraph_mcp_server-0.3.2 → msgraph_mcp_server-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "msgraph-mcp-server"
-version = "0.3.2"
+version = "0.4.0"
 description = "MCP server for Microsoft Graph: Outlook mail and calendar, plus read-only Microsoft Teams"
 readme = "README.md"
 license = "MIT"

{msgraph_mcp_server-0.3.2 → msgraph_mcp_server-0.4.0}/server.json

@@ -7,12 +7,12 @@
     "url": "https://github.com/timfurlong/msgraph-mcp",
     "source": "github"
   },
-  "version": "0.3.2",
+  "version": "0.4.0",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "msgraph-mcp-server",
-      "version": "0.3.2",
+      "version": "0.4.0",
       "runtimeHint": "uvx",
       "transport": {
         "type": "stdio"

{msgraph_mcp_server-0.3.2 → msgraph_mcp_server-0.4.0}/src/msgraph_mcp/tools/calendar.py

@@ -13,6 +13,7 @@ from msgraph.generated.models.body_type import BodyType
 from msgraph.generated.models.date_time_time_zone import DateTimeTimeZone
 from msgraph.generated.models.email_address import EmailAddress
 from msgraph.generated.models.event import Event
+from msgraph.generated.models.free_busy_status import FreeBusyStatus
 from msgraph.generated.models.item_body import ItemBody
 from msgraph.generated.models.location import Location
 from msgraph.generated.models.time_constraint import TimeConstraint
@@ -53,6 +54,16 @@ _VALID_RESPONSES = {
     "decline": "declined",
 }
 
+ShowAs = Literal["free", "tentative", "busy", "oof", "workingElsewhere"]
+
+_SHOW_AS = {
+    "free": FreeBusyStatus.Free,
+    "tentative": FreeBusyStatus.Tentative,
+    "busy": FreeBusyStatus.Busy,
+    "oof": FreeBusyStatus.Oof,
+    "workingElsewhere": FreeBusyStatus.WorkingElsewhere,
+}
+
 
 async def list_calendars(
     *, graph, mailbox: str | None = None, include_raw: bool = False
@@ -170,6 +181,12 @@ def _dttz(dt: str, tz: str) -> DateTimeTimeZone:
     return obj
 
 
+def _free_busy(show_as: str) -> FreeBusyStatus:
+    if show_as not in _SHOW_AS:
+        raise GraphValidationError(f"show_as must be one of {sorted(_SHOW_AS)}")
+    return _SHOW_AS[show_as]
+
+
 def _build_event(
     *,
     subject: str,
@@ -182,6 +199,7 @@ def _build_event(
     attendees: list[str] | None,
     is_online_meeting: bool,
     is_all_day: bool,
+    show_as: ShowAs | None,
 ) -> Event:
     e = Event()
     e.subject = subject
@@ -208,6 +226,8 @@ def _build_event(
         e.attendees = atts
     e.is_online_meeting = is_online_meeting
     e.is_all_day = is_all_day
+    if show_as is not None:
+        e.show_as = _free_busy(show_as)
     return e
 
 
@@ -224,6 +244,7 @@ async def create_event(
     attendees: list[str] | None = None,
     is_online_meeting: bool = False,
     is_all_day: bool = False,
+    show_as: ShowAs | None = None,
     calendar_id: str | None = None,
     mailbox: str | None = None,
     include_raw: bool = False,
@@ -240,6 +261,8 @@ async def create_event(
         attendees: Optional list of attendee email addresses (treated as required).
         is_online_meeting: When True, Outlook adds a Teams meeting link.
         is_all_day: All-day event flag.
+        show_as: Free/busy status shown to others: "free", "tentative", "busy",
+            "oof", or "workingElsewhere". Omit for Outlook's default ("busy").
         calendar_id: Optional calendar id; default is the user's primary calendar.
         mailbox: Optional mailbox.
 
@@ -257,6 +280,7 @@ async def create_event(
         attendees=attendees,
         is_online_meeting=is_online_meeting,
         is_all_day=is_all_day,
+        show_as=show_as,
     )
     try:
         target = graph.mailbox(mailbox)
@@ -285,12 +309,16 @@ async def update_event(
     location: str | None = None,
     is_online_meeting: bool | None = None,
     is_all_day: bool | None = None,
+    show_as: ShowAs | None = None,
     mailbox: str | None = None,
     include_raw: bool = False,
 ) -> dict:
     """Patch fields of an existing event. Pass None to leave a field unchanged.
 
     If you change start_datetime or end_datetime, you must also pass time_zone.
+
+    show_as sets the free/busy status shown to others: "free", "tentative",
+    "busy", "oof", or "workingElsewhere".
     """
     if (start_datetime or end_datetime) and not time_zone:
         raise GraphValidationError("time_zone is required when updating start or end")
@@ -314,6 +342,8 @@ async def update_event(
         patch.is_online_meeting = is_online_meeting
     if is_all_day is not None:
         patch.is_all_day = is_all_day
+    if show_as is not None:
+        patch.show_as = _free_busy(show_as)
     try:
         updated = await graph.mailbox(mailbox).events.by_event_id(event_id).patch(patch)
     except NotAuthenticatedError:
@@ -547,6 +577,7 @@ def register(mcp, *, graph) -> None:
         attendees: list[str] | None = None,
         is_online_meeting: bool = False,
         is_all_day: bool = False,
+        show_as: ShowAs | None = None,
         calendar_id: str | None = None,
         mailbox: str | None = None,
         include_raw: bool = False,
@@ -563,6 +594,7 @@ def register(mcp, *, graph) -> None:
             attendees=attendees,
             is_online_meeting=is_online_meeting,
             is_all_day=is_all_day,
+            show_as=show_as,
             calendar_id=calendar_id,
             mailbox=mailbox,
             include_raw=include_raw,
@@ -580,6 +612,7 @@ def register(mcp, *, graph) -> None:
         location: str | None = None,
         is_online_meeting: bool | None = None,
         is_all_day: bool | None = None,
+        show_as: ShowAs | None = None,
         mailbox: str | None = None,
         include_raw: bool = False,
     ):
@@ -595,6 +628,7 @@ def register(mcp, *, graph) -> None:
             location=location,
             is_online_meeting=is_online_meeting,
             is_all_day=is_all_day,
+            show_as=show_as,
             mailbox=mailbox,
             include_raw=include_raw,
         )

{msgraph_mcp_server-0.3.2 → msgraph_mcp_server-0.4.0}/tests/test_tools_calendar.py

@@ -2,6 +2,7 @@ from types import SimpleNamespace
 from unittest.mock import AsyncMock, MagicMock
 
 import pytest
+from msgraph.generated.models.free_busy_status import FreeBusyStatus
 
 from msgraph_mcp.graph.errors import GraphValidationError
 from msgraph_mcp.tools import calendar as cal_tools
@@ -134,6 +135,99 @@ async def test_update_event_patches():
     assert result["id"] == "e1"
 
 
+@pytest.mark.asyncio
+async def test_create_event_sets_show_as():
+    graph = MagicMock()
+    mb = MagicMock()
+    mb.events.post = AsyncMock(return_value=_fake_event(id_="new1"))
+    graph.mailbox = MagicMock(return_value=mb)
+
+    await cal_tools.create_event(
+        graph=graph,
+        subject="Focus time",
+        start_datetime="2026-05-19T15:00:00",
+        end_datetime="2026-05-19T15:30:00",
+        show_as="free",
+    )
+    assert mb.events.post.await_args is not None
+    posted = mb.events.post.await_args.args[0]
+    assert posted.show_as == FreeBusyStatus.Free
+
+
+@pytest.mark.asyncio
+async def test_create_event_leaves_show_as_unset_by_default():
+    graph = MagicMock()
+    mb = MagicMock()
+    mb.events.post = AsyncMock(return_value=_fake_event(id_="new1"))
+    graph.mailbox = MagicMock(return_value=mb)
+
+    await cal_tools.create_event(
+        graph=graph,
+        subject="Standup",
+        start_datetime="2026-05-19T15:00:00",
+        end_datetime="2026-05-19T15:30:00",
+    )
+    assert mb.events.post.await_args is not None
+    posted = mb.events.post.await_args.args[0]
+    assert posted.show_as is None
+
+
+@pytest.mark.asyncio
+async def test_create_event_rejects_bad_show_as():
+    graph = MagicMock()
+    with pytest.raises(GraphValidationError):
+        await cal_tools.create_event(
+            graph=graph,
+            subject="Standup",
+            start_datetime="2026-05-19T15:00:00",
+            end_datetime="2026-05-19T15:30:00",
+            show_as="available",  # type: ignore[arg-type]
+        )
+
+
+@pytest.mark.asyncio
+async def test_update_event_patches_show_as():
+    graph = MagicMock()
+    mb = MagicMock()
+    evt_builder = MagicMock(patch=AsyncMock(return_value=_fake_event(id_="e1")))
+    mb.events.by_event_id = MagicMock(return_value=evt_builder)
+    graph.mailbox = MagicMock(return_value=mb)
+
+    await cal_tools.update_event(graph=graph, event_id="e1", show_as="workingElsewhere")
+    patched = evt_builder.patch.await_args.args[0]
+    assert patched.show_as == FreeBusyStatus.WorkingElsewhere
+
+
+@pytest.mark.asyncio
+async def test_update_event_rejects_bad_show_as():
+    graph = MagicMock()
+    with pytest.raises(GraphValidationError):
+        await cal_tools.update_event(
+            graph=graph,
+            event_id="e1",
+            show_as="available",  # type: ignore[arg-type]
+        )
+
+
+def test_register_exposes_show_as_on_create_and_update():
+    import inspect
+
+    registered: dict = {}
+
+    class FakeMCP:
+        def tool(self, *, name, description=""):  # noqa: ARG002
+            def deco(fn):
+                registered[name] = fn
+                return fn
+
+            return deco
+
+    cal_tools.register(FakeMCP(), graph=MagicMock())
+
+    for name in ("create_event", "update_event"):
+        assert "show_as" in inspect.signature(registered[name]).parameters
+
+
 @pytest.mark.asyncio
 async def test_delete_event_calls_delete():
     graph = MagicMock()

{msgraph_mcp_server-0.3.2 → msgraph_mcp_server-0.4.0}/uv.lock

@@ -827,7 +827,7 @@ wheels = [
 
 [[package]]
 name = "msgraph-mcp-server"
-version = "0.3.2"
+version = "0.4.0"
 source = { editable = "." }
 dependencies = [
     { name = "mcp" },