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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: msgraph-mcp-server
-Version: 0.3.2
+Version: 0.5.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.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "msgraph-mcp-server"
-version = "0.3.2"
+version = "0.5.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.5.0}/server.json

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

{msgraph_mcp_server-0.3.2 → msgraph_mcp_server-0.5.0}/src/msgraph_mcp/graph/serialize.py

@@ -188,6 +188,10 @@ def event_to_dict(evt: Any) -> dict:
         "body": _body_to_dict(getattr(evt, "body", None)),
         "showAs": _enum_value(getattr(evt, "show_as", None)),
         "sensitivity": _enum_value(getattr(evt, "sensitivity", None)),
+        "isReminderOn": getattr(evt, "is_reminder_on", None),
+        "reminderMinutesBeforeStart": getattr(
+            evt, "reminder_minutes_before_start", None
+        ),
         "recurrence": getattr(evt, "recurrence", None),
         "webLink": getattr(evt, "web_link", None),
     }

{msgraph_mcp_server-0.3.2 → msgraph_mcp_server-0.5.0}/src/msgraph_mcp/graph/trimming.py

@@ -101,6 +101,8 @@ def trim_event(raw: dict, *, include_body: bool, include_raw: bool) -> dict:
         "body_preview": raw.get("bodyPreview"),
         "show_as": raw.get("showAs"),
         "sensitivity": raw.get("sensitivity"),
+        "is_reminder_on": raw.get("isReminderOn"),
+        "reminder_minutes_before_start": raw.get("reminderMinutesBeforeStart"),
         "recurrence": raw.get("recurrence"),
         "web_link": raw.get("webLink"),
     }

{msgraph_mcp_server-0.3.2 → msgraph_mcp_server-0.5.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,34 @@ 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 _apply_reminder(
+    evt: Event,
+    *,
+    is_reminder_on: bool | None,
+    reminder_minutes_before_start: int | None,
+) -> None:
+    """Set reminder fields on evt. Giving minutes turns the reminder on."""
+    if reminder_minutes_before_start is not None:
+        if reminder_minutes_before_start < 0:
+            raise GraphValidationError(
+                "reminder_minutes_before_start must be zero or greater"
+            )
+        if is_reminder_on is False:
+            raise GraphValidationError(
+                "reminder_minutes_before_start cannot be set when is_reminder_on is False"
+            )
+        evt.reminder_minutes_before_start = reminder_minutes_before_start
+        evt.is_reminder_on = True
+    elif is_reminder_on is not None:
+        evt.is_reminder_on = is_reminder_on
+
+
 def _build_event(
     *,
     subject: str,
@@ -182,6 +221,9 @@ def _build_event(
     attendees: list[str] | None,
     is_online_meeting: bool,
     is_all_day: bool,
+    show_as: ShowAs | None,
+    is_reminder_on: bool | None,
+    reminder_minutes_before_start: int | None,
 ) -> Event:
     e = Event()
     e.subject = subject
@@ -208,6 +250,13 @@ 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)
+    _apply_reminder(
+        e,
+        is_reminder_on=is_reminder_on,
+        reminder_minutes_before_start=reminder_minutes_before_start,
+    )
     return e
 
 
@@ -224,6 +273,9 @@ async def create_event(
     attendees: list[str] | None = None,
     is_online_meeting: bool = False,
     is_all_day: bool = False,
+    show_as: ShowAs | None = None,
+    is_reminder_on: bool | None = None,
+    reminder_minutes_before_start: int | None = None,
     calendar_id: str | None = None,
     mailbox: str | None = None,
     include_raw: bool = False,
@@ -240,6 +292,12 @@ 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").
+        is_reminder_on: False creates the event with no reminder. Omit for
+            Outlook's default (a reminder 15 minutes before start).
+        reminder_minutes_before_start: Minutes before start to alert (0 or
+            more). Setting this turns the reminder on.
         calendar_id: Optional calendar id; default is the user's primary calendar.
         mailbox: Optional mailbox.
 
@@ -257,6 +315,9 @@ async def create_event(
         attendees=attendees,
         is_online_meeting=is_online_meeting,
         is_all_day=is_all_day,
+        show_as=show_as,
+        is_reminder_on=is_reminder_on,
+        reminder_minutes_before_start=reminder_minutes_before_start,
     )
     try:
         target = graph.mailbox(mailbox)
@@ -285,12 +346,22 @@ 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,
+    is_reminder_on: bool | None = None,
+    reminder_minutes_before_start: int | 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".
+
+    is_reminder_on=False removes the reminder. reminder_minutes_before_start
+    sets how many minutes before start to alert (0 or more) and turns the
+    reminder on.
     """
     if (start_datetime or end_datetime) and not time_zone:
         raise GraphValidationError("time_zone is required when updating start or end")
@@ -314,6 +385,13 @@ 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)
+    _apply_reminder(
+        patch,
+        is_reminder_on=is_reminder_on,
+        reminder_minutes_before_start=reminder_minutes_before_start,
+    )
     try:
         updated = await graph.mailbox(mailbox).events.by_event_id(event_id).patch(patch)
     except NotAuthenticatedError:
@@ -547,6 +625,9 @@ 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,
+        is_reminder_on: bool | None = None,
+        reminder_minutes_before_start: int | None = None,
         calendar_id: str | None = None,
         mailbox: str | None = None,
         include_raw: bool = False,
@@ -563,6 +644,9 @@ def register(mcp, *, graph) -> None:
             attendees=attendees,
             is_online_meeting=is_online_meeting,
             is_all_day=is_all_day,
+            show_as=show_as,
+            is_reminder_on=is_reminder_on,
+            reminder_minutes_before_start=reminder_minutes_before_start,
             calendar_id=calendar_id,
             mailbox=mailbox,
             include_raw=include_raw,
@@ -580,6 +664,9 @@ 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,
+        is_reminder_on: bool | None = None,
+        reminder_minutes_before_start: int | None = None,
         mailbox: str | None = None,
         include_raw: bool = False,
     ):
@@ -595,6 +682,9 @@ def register(mcp, *, graph) -> None:
             location=location,
             is_online_meeting=is_online_meeting,
             is_all_day=is_all_day,
+            show_as=show_as,
+            is_reminder_on=is_reminder_on,
+            reminder_minutes_before_start=reminder_minutes_before_start,
             mailbox=mailbox,
             include_raw=include_raw,
         )

{msgraph_mcp_server-0.3.2 → msgraph_mcp_server-0.5.0}/tests/fixtures/event_minimal.json

@@ -20,6 +20,8 @@
   "body": {"contentType": "html", "content": "<p>Daily standup</p>"},
   "showAs": "busy",
   "sensitivity": "normal",
+  "isReminderOn": true,
+  "reminderMinutesBeforeStart": 15,
   "recurrence": null,
   "webLink": "https://outlook.office.com/owa/?ItemID=evt"
 }

{msgraph_mcp_server-0.3.2 → msgraph_mcp_server-0.5.0}/tests/test_graph_serialize.py

@@ -151,6 +151,18 @@ def test_message_rule_predicates_to_dict_minimal():
     assert d["fromAddresses"] == []
 
 
+def test_event_to_dict_includes_reminder():
+    evt = SimpleNamespace(
+        id="e1",
+        is_reminder_on=True,
+        reminder_minutes_before_start=30,
+        additional_data={},
+    )
+    d = serialize.event_to_dict(evt)
+    assert d["isReminderOn"] is True
+    assert d["reminderMinutesBeforeStart"] == 30
+
+
 def test_message_rule_actions_to_dict_minimal():
     actions = SimpleNamespace(
         assign_categories=None,

{msgraph_mcp_server-0.3.2 → msgraph_mcp_server-0.5.0}/tests/test_graph_trimming.py

@@ -84,6 +84,13 @@ def test_trim_event_minimal():
     assert "body" not in t
 
 
+def test_trim_event_includes_reminder():
+    raw = load("event_minimal.json")
+    t = trimming.trim_event(raw, include_body=False, include_raw=False)
+    assert t["is_reminder_on"] is True
+    assert t["reminder_minutes_before_start"] == 15
+
+
 def test_trim_event_with_body_and_raw():
     raw = load("event_minimal.json")
     t = trimming.trim_event(raw, include_body=True, include_raw=True)

{msgraph_mcp_server-0.3.2 → msgraph_mcp_server-0.5.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,199 @@ 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
+
+
+async def _create_with(**kwargs):
+    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",
+        **kwargs,
+    )
+    assert mb.events.post.await_args is not None
+    return mb.events.post.await_args.args[0]
+
+
+async def _update_with(**kwargs):
+    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", **kwargs)
+    return evt_builder.patch.await_args.args[0]
+
+
+@pytest.mark.asyncio
+async def test_create_event_can_turn_reminder_off():
+    posted = await _create_with(is_reminder_on=False)
+    assert posted.is_reminder_on is False
+    assert posted.reminder_minutes_before_start is None
+
+
+@pytest.mark.asyncio
+async def test_create_event_reminder_minutes_turns_reminder_on():
+    posted = await _create_with(reminder_minutes_before_start=60)
+    assert posted.reminder_minutes_before_start == 60
+    assert posted.is_reminder_on is True
+
+
+@pytest.mark.asyncio
+async def test_create_event_leaves_reminder_unset_by_default():
+    posted = await _create_with()
+    assert posted.is_reminder_on is None
+    assert posted.reminder_minutes_before_start is None
+
+
+@pytest.mark.asyncio
+async def test_create_event_rejects_negative_reminder_minutes():
+    with pytest.raises(GraphValidationError):
+        await _create_with(reminder_minutes_before_start=-5)
+
+
+@pytest.mark.asyncio
+async def test_create_event_rejects_minutes_with_reminder_off():
+    with pytest.raises(GraphValidationError):
+        await _create_with(is_reminder_on=False, reminder_minutes_before_start=10)
+
+
+@pytest.mark.asyncio
+async def test_update_event_can_turn_reminder_off():
+    patched = await _update_with(is_reminder_on=False)
+    assert patched.is_reminder_on is False
+    assert patched.reminder_minutes_before_start is None
+
+
+@pytest.mark.asyncio
+async def test_update_event_reminder_minutes_turns_reminder_on():
+    patched = await _update_with(reminder_minutes_before_start=0)
+    assert patched.reminder_minutes_before_start == 0
+    assert patched.is_reminder_on is True
+
+
+@pytest.mark.asyncio
+async def test_update_event_rejects_negative_reminder_minutes():
+    with pytest.raises(GraphValidationError):
+        await _update_with(reminder_minutes_before_start=-1)
+
+
+def test_register_exposes_reminder_params_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"):
+        params = inspect.signature(registered[name]).parameters
+        assert "is_reminder_on" in params
+        assert "reminder_minutes_before_start" in params
+
+
 @pytest.mark.asyncio
 async def test_delete_event_calls_delete():
     graph = MagicMock()

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

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