ldraney-notion-mcp 0.1.4__py3-none-any.whl → 0.1.5__py3-none-any.whl

{ldraney_notion_mcp-0.1.4.dist-info → ldraney_notion_mcp-0.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ldraney-notion-mcp
-Version: 0.1.4
+Version: 0.1.5
 Summary: MCP server wrapping the Notion Python SDK (v2025-09-03)
 License: MIT
 Requires-Python: >=3.10

ldraney_notion_mcp-0.1.5.dist-info/RECORD

@@ -0,0 +1,15 @@
+notion_mcp/__init__.py,sha256=Wy2Os0Ww79mbGvySlmb9IVPW9t-oUPO246-8PppLqUI,105
+notion_mcp/__main__.py,sha256=8iuAFwnkWnvYNFN7qLyPeNa-qlKbzQMO6b7li5yrRFU,83
+notion_mcp/server.py,sha256=eJPqXMqo1AGVTozjWkON8ys1oe5wraiB1dmHz1wqU6M,2324
+notion_mcp/tools/__init__.py,sha256=Dak6lGr2H_aG5SYNAfi_1lACTqwAPDAAjIyVmGja8as,496
+notion_mcp/tools/blocks.py,sha256=c9fBMrr1LFv_2kkt13Be4R_T9kZzR67Ptik82dA0foM,3487
+notion_mcp/tools/comments.py,sha256=OoH5hhWgmuHn94fzIemL8I7OhmOp7QnaCNTZ35qfECc,2436
+notion_mcp/tools/databases.py,sha256=d9NF695xB-1Z8KXEYuPD-evjQUC4FonXHa_t_TxGNHw,10044
+notion_mcp/tools/pages.py,sha256=pBQdwEB5aZc1yUulnlsVfJ1NMT5Fr-rcFeXX8mCtodM,5233
+notion_mcp/tools/search.py,sha256=7rhAFS4ROJFqlJvFFuLiCd2KJ_qrVeidqHtSVH-v0Rs,1700
+notion_mcp/tools/users.py,sha256=psYUJm0PT--xVfSSQA1XzBCzNewgDbmCjkF1_XTcsoE,1117
+ldraney_notion_mcp-0.1.5.dist-info/METADATA,sha256=hKqlj4yFn03agAJ56ElkHMh1LH5pQi4WU7GH-Sz0JWw,4542
+ldraney_notion_mcp-0.1.5.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+ldraney_notion_mcp-0.1.5.dist-info/entry_points.txt,sha256=rv-l84lsnJ83vSLGoJlfoQsc-IQHRevhU1_NiIZyI3M,62
+ldraney_notion_mcp-0.1.5.dist-info/top_level.txt,sha256=lFXGlrgRGHEtgwNKPCohd0H0PxUReLzGdpd6YzborzM,11
+ldraney_notion_mcp-0.1.5.dist-info/RECORD,,

notion_mcp/tools/blocks.py

@@ -53,15 +53,13 @@ def get_block_children(
 @mcp.tool()
 def append_block_children(
     block_id: Annotated[str, Field(description="The UUID of the parent block to append children to")],
-    children: Annotated[str, Field(description="JSON string for a list of block objects to append, e.g. '[{\"object\": \"block\", \"type\": \"paragraph\", \"paragraph\": {\"rich_text\": [{\"type\": \"text\", \"text\": {\"content\": \"Hello\"}}]}}]'")],
+    children: Annotated[str | list, Field(description="JSON string or array for a list of block objects to append")],
 ) -> str:
     """Append child blocks to a Notion block.
 
-    IMPORTANT: The children parameter must be passed as a JSON-encoded string, NOT as an object.
-
     Args:
         block_id: The UUID of the parent block to append children to.
-        children: JSON string for a list of block objects to append.
+        children: JSON string or array for a list of block objects to append.
     """
     try:
         result = get_client().append_block_children(
@@ -76,16 +74,14 @@ def append_block_children(
 @mcp.tool()
 def update_block(
     block_id: Annotated[str, Field(description="The UUID of the block to update")],
-    content: Annotated[str | None, Field(description="JSON string of block properties to update. The keys depend on the block type, e.g. '{\"paragraph\": {\"rich_text\": [{\"type\": \"text\", \"text\": {\"content\": \"Updated text\"}}]}}'")] = None,
+    content: Annotated[str | dict | None, Field(description="JSON string or object of block properties to update. The keys depend on the block type, e.g. {\"paragraph\": {\"rich_text\": [...]}}")] = None,
 ) -> str:
     """Update a Notion block.
 
-    IMPORTANT: The content parameter must be passed as a JSON-encoded string, NOT as an object.
-
     Args:
         block_id: The UUID of the block to update.
-        content: JSON string of block properties to update. The keys depend
-            on the block type (e.g. '{"paragraph": {"rich_text": [...]}}').
+        content: JSON string or object of block properties to update. The keys depend
+            on the block type (e.g. {"paragraph": {"rich_text": [...]}}).
     """
     try:
         kwargs: dict[str, Any] = {}

notion_mcp/tools/comments.py

@@ -12,19 +12,17 @@ from ..server import mcp, get_client, _parse_json, _error_response
 
 @mcp.tool()
 def create_comment(
-    parent: Annotated[str, Field(description="JSON string for the parent object, e.g. '{\"page_id\": \"...\"}'")],
-    rich_text: Annotated[str, Field(description="JSON string for the rich-text content array, e.g. '[{\"type\": \"text\", \"text\": {\"content\": \"Hello!\"}}]'")],
+    parent: Annotated[str | dict, Field(description="JSON string or object for the parent, e.g. {\"page_id\": \"...\"}")],
+    rich_text: Annotated[str | list, Field(description="JSON string or array for the rich-text content, e.g. [{\"type\": \"text\", \"text\": {\"content\": \"Hello!\"}}]")],
     discussion_id: Annotated[str | None, Field(description="UUID of an existing discussion thread to reply to. Omit to start a new top-level comment.")] = None,
 ) -> str:
     """Create a comment on a Notion page or block.
 
-    IMPORTANT: parent and rich_text must be passed as JSON-encoded strings, NOT as objects.
-
     Args:
-        parent: JSON string for the parent object,
-            e.g. '{"page_id": "..."}'.
-        rich_text: JSON string for the rich-text content array,
-            e.g. '[{"type": "text", "text": {"content": "Hello!"}}]'.
+        parent: JSON string or object for the parent,
+            e.g. {"page_id": "..."}.
+        rich_text: JSON string or array for the rich-text content,
+            e.g. [{"type": "text", "text": {"content": "Hello!"}}].
         discussion_id: Optional UUID of an existing discussion thread
             to reply to. Omit to start a new top-level comment.
     """

notion_mcp/tools/databases.py

@@ -17,22 +17,20 @@ from ..server import mcp, get_client, _parse_json, _error_response
 
 @mcp.tool()
 def create_database(
-    parent: Annotated[str, Field(description="JSON string for the parent object, e.g. '{\"type\": \"page_id\", \"page_id\": \"...\"}'")],
-    title: Annotated[str, Field(description="JSON string for the title rich-text array, e.g. '[{\"type\": \"text\", \"text\": {\"content\": \"My DB\"}}]'")],
-    initial_data_source: Annotated[str | None, Field(description="JSON string for the initial data source configuration including properties")] = None,
+    parent: Annotated[str | dict, Field(description="JSON string or object for the parent, e.g. {\"type\": \"page_id\", \"page_id\": \"...\"}")],
+    title: Annotated[str | list, Field(description="JSON string or array for the title rich-text array, e.g. [{\"type\": \"text\", \"text\": {\"content\": \"My DB\"}}]")],
+    initial_data_source: Annotated[str | dict | None, Field(description="JSON string or object for the initial data source configuration including properties")] = None,
 ) -> str:
     """Create a new Notion database.
 
     In Notion API v2025-09-03, database properties live on data sources.
     Pass properties inside initial_data_source.properties.
 
-    IMPORTANT: All structured parameters must be passed as JSON-encoded strings, NOT as objects.
-
     Args:
-        parent: JSON string for the parent object, e.g. '{"type": "page_id", "page_id": "..."}'.
-        title: JSON string for the title rich-text array,
-            e.g. '[{"type": "text", "text": {"content": "My DB"}}]'.
-        initial_data_source: Optional JSON string for the initial data source
+        parent: JSON string or object for the parent, e.g. {"type": "page_id", "page_id": "..."}.
+        title: JSON string or array for the title rich-text array,
+            e.g. [{"type": "text", "text": {"content": "My DB"}}].
+        initial_data_source: Optional JSON string or object for the initial data source
             configuration including properties.
     """
     try:
@@ -68,21 +66,19 @@ def get_database(
 @mcp.tool()
 def update_database(
     database_id: Annotated[str, Field(description="The UUID of the database to update")],
-    title: Annotated[str | None, Field(description="JSON string for the new title rich-text array, e.g. '[{\"type\": \"text\", \"text\": {\"content\": \"New Title\"}}]'")] = None,
-    description: Annotated[str | None, Field(description="JSON string for the description rich-text array, e.g. '[{\"type\": \"text\", \"text\": {\"content\": \"A description\"}}]'")] = None,
-    icon: Annotated[str | None, Field(description="JSON string for the database icon, e.g. '{\"type\": \"emoji\", \"emoji\": \"📊\"}'")] = None,
-    cover: Annotated[str | None, Field(description="JSON string for the database cover, e.g. '{\"type\": \"external\", \"external\": {\"url\": \"https://...\"}}'")] = None,
+    title: Annotated[str | list | None, Field(description="JSON string or array for the new title rich-text array")] = None,
+    description: Annotated[str | list | None, Field(description="JSON string or array for the description rich-text array")] = None,
+    icon: Annotated[str | dict | None, Field(description="JSON string or object for the database icon, e.g. {\"type\": \"emoji\", \"emoji\": \"...\"}")] = None,
+    cover: Annotated[str | dict | None, Field(description="JSON string or object for the database cover, e.g. {\"type\": \"external\", \"external\": {\"url\": \"https://...\"}}")] = None,
 ) -> str:
     """Update a Notion database.
 
-    IMPORTANT: All structured parameters must be passed as JSON-encoded strings, NOT as objects.
-
     Args:
         database_id: The UUID of the database to update.
-        title: Optional JSON string for the new title rich-text array.
-        description: Optional JSON string for the description rich-text array.
-        icon: Optional JSON string for the database icon.
-        cover: Optional JSON string for the database cover.
+        title: Optional JSON string or array for the new title rich-text array.
+        description: Optional JSON string or array for the description rich-text array.
+        icon: Optional JSON string or object for the database icon.
+        cover: Optional JSON string or object for the database cover.
     """
     try:
         kwargs: dict[str, Any] = {}
@@ -119,8 +115,8 @@ def archive_database(
 @mcp.tool()
 def query_database(
     database_id: Annotated[str, Field(description="The UUID of the database to query")],
-    filter: Annotated[str | None, Field(description="JSON string for a filter object, e.g. '{\"property\": \"Status\", \"select\": {\"equals\": \"Done\"}}'")] = None,
-    sorts: Annotated[str | None, Field(description="JSON string for a list of sort objects, e.g. '[{\"property\": \"Created\", \"direction\": \"descending\"}]'")] = None,
+    filter: Annotated[str | dict | None, Field(description="JSON string or object for a filter, e.g. {\"property\": \"Status\", \"select\": {\"equals\": \"Done\"}}")] = None,
+    sorts: Annotated[str | list | None, Field(description="JSON string or array for a list of sort objects, e.g. [{\"property\": \"Created\", \"direction\": \"descending\"}]")] = None,
     start_cursor: Annotated[str | None, Field(description="Cursor for pagination")] = None,
     page_size: Annotated[int | None, Field(description="Number of results per page")] = None,
 ) -> str:
@@ -129,12 +125,10 @@ def query_database(
     Automatically resolves the first data source and queries it.
     If you already know the data source ID, use query_data_source instead.
 
-    IMPORTANT: filter and sorts must be passed as JSON-encoded strings, NOT as objects.
-
     Args:
         database_id: The UUID of the database to query.
-        filter: Optional JSON string for a filter object.
-        sorts: Optional JSON string for a list of sort objects.
+        filter: Optional JSON string or object for a filter.
+        sorts: Optional JSON string or array for a list of sort objects.
         start_cursor: Optional cursor for pagination.
         page_size: Optional number of results per page.
     """
@@ -175,15 +169,13 @@ def get_data_source(
 @mcp.tool()
 def update_data_source(
     data_source_id: Annotated[str, Field(description="The UUID of the data source to update")],
-    properties: Annotated[str | None, Field(description="JSON string for properties to update, e.g. '{\"Name\": {\"title\": {}}, \"Tags\": {\"multi_select\": {}}}'")] = None,
+    properties: Annotated[str | dict | None, Field(description="JSON string or object for properties to update")] = None,
 ) -> str:
     """Update a Notion data source.
 
-    IMPORTANT: The properties parameter must be passed as a JSON-encoded string, NOT as an object.
-
     Args:
         data_source_id: The UUID of the data source to update.
-        properties: Optional JSON string for properties to update.
+        properties: Optional JSON string or object for properties to update.
     """
     try:
         kwargs: dict[str, Any] = {}
@@ -198,19 +190,17 @@ def update_data_source(
 @mcp.tool()
 def query_data_source(
     data_source_id: Annotated[str, Field(description="The UUID of the data source to query")],
-    filter: Annotated[str | None, Field(description="JSON string for a filter object, e.g. '{\"property\": \"Status\", \"select\": {\"equals\": \"Done\"}}'")] = None,
-    sorts: Annotated[str | None, Field(description="JSON string for a list of sort objects, e.g. '[{\"property\": \"Created\", \"direction\": \"descending\"}]'")] = None,
+    filter: Annotated[str | dict | None, Field(description="JSON string or object for a filter, e.g. {\"property\": \"Status\", \"select\": {\"equals\": \"Done\"}}")] = None,
+    sorts: Annotated[str | list | None, Field(description="JSON string or array for a list of sort objects, e.g. [{\"property\": \"Created\", \"direction\": \"descending\"}]")] = None,
     start_cursor: Annotated[str | None, Field(description="Cursor for pagination")] = None,
     page_size: Annotated[int | None, Field(description="Number of results per page")] = None,
 ) -> str:
     """Query rows in a Notion data source.
 
-    IMPORTANT: filter and sorts must be passed as JSON-encoded strings, NOT as objects.
-
     Args:
         data_source_id: The UUID of the data source to query.
-        filter: Optional JSON string for a filter object.
-        sorts: Optional JSON string for a list of sort objects.
+        filter: Optional JSON string or object for a filter.
+        sorts: Optional JSON string or array for a list of sort objects.
         start_cursor: Optional cursor for pagination.
         page_size: Optional number of results per page.
     """

notion_mcp/tools/pages.py

@@ -12,23 +12,21 @@ from ..server import mcp, get_client, _parse_json, _error_response
 
 @mcp.tool()
 def create_page(
-    parent: Annotated[str, Field(description="JSON string for the parent object, e.g. '{\"type\": \"page_id\", \"page_id\": \"...\"}'")],
-    properties: Annotated[str, Field(description="JSON string for the page properties mapping, e.g. '{\"title\": [{\"text\": {\"content\": \"My Page\"}}]}'")],
-    children: Annotated[str | None, Field(description="JSON string for a list of block children to append. Cannot be used together with template.")] = None,
-    template: Annotated[str | None, Field(description="JSON string for a data-source template, e.g. '{\"type\": \"none\"}', '{\"type\": \"default\"}', or '{\"type\": \"template_id\", \"template_id\": \"<uuid>\"}'")] = None,
+    parent: Annotated[str | dict, Field(description="JSON string or object for the parent, e.g. {\"type\": \"page_id\", \"page_id\": \"...\"}")],
+    properties: Annotated[str | dict, Field(description="JSON string or object for the page properties mapping")],
+    children: Annotated[str | list | None, Field(description="JSON string or array for a list of block children to append. Cannot be used together with template.")] = None,
+    template: Annotated[str | dict | None, Field(description="JSON string or object for a data-source template, e.g. {\"type\": \"none\"}, {\"type\": \"default\"}, or {\"type\": \"template_id\", \"template_id\": \"<uuid>\"}")] = None,
 ) -> str:
     """Create a new Notion page.
 
-    IMPORTANT: All structured parameters must be passed as JSON-encoded strings, NOT as objects.
-
     Args:
-        parent: JSON string for the parent object, e.g. '{"type": "page_id", "page_id": "..."}'.
-        properties: JSON string for the page properties mapping.
-        children: Optional JSON string for a list of block children to append.
+        parent: JSON string or object for the parent object, e.g. {"type": "page_id", "page_id": "..."}.
+        properties: JSON string or object for the page properties mapping.
+        children: Optional JSON string or array for a list of block children to append.
             Cannot be used together with template.
-        template: Optional JSON string for a data-source template, e.g.
-            '{"type": "none"}', '{"type": "default"}', or
-            '{"type": "template_id", "template_id": "<uuid>"}'.
+        template: Optional JSON string or object for a data-source template, e.g.
+            {"type": "none"}, {"type": "default"}, or
+            {"type": "template_id", "template_id": "<uuid>"}.
     """
     try:
         result = get_client().create_page(
@@ -61,22 +59,20 @@ def get_page(
 @mcp.tool()
 def update_page(
     page_id: Annotated[str, Field(description="The UUID of the page to update")],
-    properties: Annotated[str | None, Field(description="JSON string of properties to update, e.g. '{\"Name\": {\"title\": [{\"text\": {\"content\": \"New Title\"}}]}}'")] = None,
+    properties: Annotated[str | dict | None, Field(description="JSON string or object of properties to update")] = None,
     erase_content: Annotated[bool | None, Field(description="If true, clears ALL block content from the page. WARNING: This is destructive and irreversible.")] = None,
-    icon: Annotated[str | None, Field(description="JSON string for the page icon, e.g. '{\"type\": \"emoji\", \"emoji\": \"🎉\"}'")] = None,
-    cover: Annotated[str | None, Field(description="JSON string for the page cover, e.g. '{\"type\": \"external\", \"external\": {\"url\": \"https://...\"}}'")] = None,
+    icon: Annotated[str | dict | None, Field(description="JSON string or object for the page icon, e.g. {\"type\": \"emoji\", \"emoji\": \"...\"}")] = None,
+    cover: Annotated[str | dict | None, Field(description="JSON string or object for the page cover, e.g. {\"type\": \"external\", \"external\": {\"url\": \"https://...\"}}")] = None,
 ) -> str:
     """Update a Notion page's properties, icon, or cover.
 
-    IMPORTANT: All structured parameters must be passed as JSON-encoded strings, NOT as objects.
-
     Args:
         page_id: The UUID of the page to update.
-        properties: Optional JSON string of properties to update.
+        properties: Optional JSON string or object of properties to update.
         erase_content: If true, clears ALL block content from the page.
             WARNING: This is destructive and irreversible.
-        icon: Optional JSON string for the page icon.
-        cover: Optional JSON string for the page cover.
+        icon: Optional JSON string or object for the page icon.
+        cover: Optional JSON string or object for the page cover.
     """
     try:
         kwargs: dict[str, Any] = {}
@@ -115,16 +111,14 @@ def archive_page(
 @mcp.tool()
 def move_page(
     page_id: Annotated[str, Field(description="The UUID of the page to move")],
-    parent: Annotated[str, Field(description="JSON string for the new parent object, e.g. '{\"type\": \"page_id\", \"page_id\": \"...\"}'")],
+    parent: Annotated[str | dict, Field(description="JSON string or object for the new parent, e.g. {\"type\": \"page_id\", \"page_id\": \"...\"}")],
 ) -> str:
     """Move a Notion page to a new parent.
 
-    IMPORTANT: The parent parameter must be passed as a JSON-encoded string, NOT as an object.
-
     Args:
         page_id: The UUID of the page to move.
-        parent: JSON string for the new parent object,
-            e.g. '{"type": "page_id", "page_id": "..."}'.
+        parent: JSON string or object for the new parent object,
+            e.g. {"type": "page_id", "page_id": "..."}.
     """
     try:
         result = get_client().move_page(

notion_mcp/tools/search.py

@@ -13,21 +13,19 @@ from ..server import mcp, get_client, _parse_json, _error_response
 @mcp.tool()
 def search(
     query: Annotated[str | None, Field(description="Text query to search for")] = None,
-    filter: Annotated[str | None, Field(description="JSON string for a filter object, e.g. '{\"value\": \"page\", \"property\": \"object\"}'")] = None,
-    sort: Annotated[str | None, Field(description="JSON string for a sort object, e.g. '{\"direction\": \"ascending\", \"timestamp\": \"last_edited_time\"}'")] = None,
+    filter: Annotated[str | dict | None, Field(description="JSON string or object for a filter, e.g. {\"value\": \"page\", \"property\": \"object\"}")] = None,
+    sort: Annotated[str | dict | None, Field(description="JSON string or object for a sort, e.g. {\"direction\": \"ascending\", \"timestamp\": \"last_edited_time\"}")] = None,
     start_cursor: Annotated[str | None, Field(description="Cursor for pagination")] = None,
     page_size: Annotated[int | None, Field(description="Number of results per page")] = None,
 ) -> str:
     """Search Notion pages and databases.
 
-    IMPORTANT: filter and sort must be passed as JSON-encoded strings, NOT as objects.
-
     Args:
         query: Optional text query to search for.
-        filter: Optional JSON string for a filter object,
-            e.g. '{"value": "page", "property": "object"}'.
-        sort: Optional JSON string for a sort object,
-            e.g. '{"direction": "ascending", "timestamp": "last_edited_time"}'.
+        filter: Optional JSON string or object for a filter,
+            e.g. {"value": "page", "property": "object"}.
+        sort: Optional JSON string or object for a sort,
+            e.g. {"direction": "ascending", "timestamp": "last_edited_time"}.
         start_cursor: Optional cursor for pagination.
         page_size: Optional number of results per page.
     """

ldraney_notion_mcp-0.1.4.dist-info/RECORD

@@ -1,15 +0,0 @@
-notion_mcp/__init__.py,sha256=Wy2Os0Ww79mbGvySlmb9IVPW9t-oUPO246-8PppLqUI,105
-notion_mcp/__main__.py,sha256=8iuAFwnkWnvYNFN7qLyPeNa-qlKbzQMO6b7li5yrRFU,83
-notion_mcp/server.py,sha256=eJPqXMqo1AGVTozjWkON8ys1oe5wraiB1dmHz1wqU6M,2324
-notion_mcp/tools/__init__.py,sha256=Dak6lGr2H_aG5SYNAfi_1lACTqwAPDAAjIyVmGja8as,496
-notion_mcp/tools/blocks.py,sha256=4IcojENzkB4I6Z8Jku7Bc4dHq5vOHjzDWwpSWcfjw6M,3845
-notion_mcp/tools/comments.py,sha256=HJ-mKbDlsY4Tz42xSO4Yt7yYqSy49YdrRW3Wd5lhXf0,2511
-notion_mcp/tools/databases.py,sha256=9M7wXrnj94rq6MXbIbHqFDxZ1al8l0YXMH5BHpd_1P8,10483
-notion_mcp/tools/pages.py,sha256=5UdwTCDCEVfQT91OA9-_aI2F3HWWYjZ-vJxqYJduZbE,5488
-notion_mcp/tools/search.py,sha256=kgjGlHZNsQ9hrI4x-CRjvMw06CyUzVraCWyyrtFxw-g,1770
-notion_mcp/tools/users.py,sha256=psYUJm0PT--xVfSSQA1XzBCzNewgDbmCjkF1_XTcsoE,1117
-ldraney_notion_mcp-0.1.4.dist-info/METADATA,sha256=Tnq--EbABcEwWXFeJp999ULiizy5wpf30RRdneCMa88,4542
-ldraney_notion_mcp-0.1.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-ldraney_notion_mcp-0.1.4.dist-info/entry_points.txt,sha256=rv-l84lsnJ83vSLGoJlfoQsc-IQHRevhU1_NiIZyI3M,62
-ldraney_notion_mcp-0.1.4.dist-info/top_level.txt,sha256=lFXGlrgRGHEtgwNKPCohd0H0PxUReLzGdpd6YzborzM,11
-ldraney_notion_mcp-0.1.4.dist-info/RECORD,,