feat(contacts): Initialize Contacts App

Author: Chris Coutinho

nextcloud_mcp_server/app.py

@@ -12,6 +12,7 @@
     configure_notes_tools,
     configure_tables_tools,
     configure_webdav_tools,
+    configure_contacts_tools,
 )
 
 setup_logging()
@@ -56,6 +57,7 @@ async def nc_get_capabilities():
 configure_tables_tools(mcp)
 configure_webdav_tools(mcp)
 configure_calendar_tools(mcp)
+configure_contacts_tools(mcp)
 
 
 def run():

nextcloud_mcp_server/client/__init__.py

@@ -5,6 +5,7 @@
 
 from ..controllers.notes_search import NotesSearchController
 from .calendar import CalendarClient
+from .contacts import ContactsClient
 from .notes import NotesClient
 from .tables import TablesClient
 from .webdav import WebDAVClient
@@ -43,6 +44,7 @@ def __init__(self, base_url: str, username: str, auth: Auth | None = None):
         self.webdav = WebDAVClient(self._client, username)
         self.tables = TablesClient(self._client, username)
         self.calendar = CalendarClient(self._client, username)
+        self.contacts = ContactsClient(self._client, username)
 
         # Initialize controllers
         self._notes_search = NotesSearchController()

nextcloud_mcp_server/server/__init__.py

@@ -2,10 +2,12 @@
 from .notes import configure_notes_tools
 from .tables import configure_tables_tools
 from .webdav import configure_webdav_tools
+from .contacts import configure_contacts_tools
 
 __all__ = [
     "configure_calendar_tools",
     "configure_notes_tools",
     "configure_tables_tools",
     "configure_webdav_tools",
+    "configure_contacts_tools",
 ]

pyproject.toml

@@ -11,7 +11,8 @@ dependencies = [
     "mcp[cli] (>=1.10,<1.11)",
     "httpx (>=0.28.1,<0.29.0)",
     "pillow (>=11.2.1,<12.0.0)",
-    "icalendar (>=6.0.0,<7.0.0)"
+    "icalendar (>=6.0.0,<7.0.0)",
+    "pythonvcard4>=0.2.0",
 ]
 
 [tool.pytest.ini_options]