ultimate-brain-mcp 0.1.0__tar.gz

ultimate_brain_mcp-0.1.0/.env.example

@@ -0,0 +1,19 @@
+# Required — Notion integration secret
+NOTION_INTEGRATION_SECRET=secret_xxx
+
+# Required — Primary database data source IDs (run setup_dev.py to auto-discover)
+UB_TASKS_DS_ID=
+UB_PROJECTS_DS_ID=
+UB_NOTES_DS_ID=
+UB_TAGS_DS_ID=
+UB_GOALS_DS_ID=
+
+# Optional — Secondary database data source IDs
+UB_WORK_SESSIONS_DS_ID=
+UB_MILESTONES_DS_ID=
+UB_PEOPLE_DS_ID=
+UB_BOOKS_DS_ID=
+UB_READING_LOG_DS_ID=
+UB_GENRES_DS_ID=
+UB_RECIPES_DS_ID=
+UB_MEAL_PLANNER_DS_ID=

ultimate_brain_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,15 @@
+name: Publish to PyPI
+on:
+  push:
+    tags: ["v*"]
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv build
+      - run: uv publish

ultimate_brain_mcp-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+.env
+__pycache__/
+*.pyc
+dist/
+build/
+*.egg-info/
+.eggs/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.so
+.venv/
+venv/

ultimate_brain_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Bobby Hyam
+
+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.

ultimate_brain_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: ultimate-brain-mcp
+Version: 0.1.0
+Summary: MCP server for Thomas Frank's Ultimate Brain Notion system
+License-Expression: MIT
+License-File: LICENSE
+Keywords: mcp,notion,para,productivity,ultimate-brain
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.28
+Requires-Dist: mcp[cli]<2,>=1.26
+Requires-Dist: pydantic>=2.12
+Description-Content-Type: text/markdown
+
+# MCP Server for Ultimate Brain
+
+An MCP server for managing Thomas Frank's Ultimate Brain Notion system. Provides 26 workflow-oriented tools for Tasks, Projects, Notes, Tags, and Goals using the PARA methodology.
+
+## Setup
+
+1. Create a [Notion integration](https://www.notion.so/my-integrations) and share your Ultimate Brain databases with it.
+
+2. Auto-discover data source IDs:
+
+```bash
+uv run python setup_dev.py
+```
+
+3. Run the server:
+
+```bash
+uv run ultimate-brain-mcp
+```
+
+## Claude Code Integration
+
+```bash
+claude mcp add ultimate-brain \
+  -e NOTION_INTEGRATION_SECRET=secret_... \
+  -e UB_TASKS_DS_ID=... \
+  -e UB_PROJECTS_DS_ID=... \
+  -e UB_NOTES_DS_ID=... \
+  -e UB_TAGS_DS_ID=... \
+  -e UB_GOALS_DS_ID=... \
+  -- uvx ultimate-brain-mcp
+```
+
+## Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ultimate-brain": {
+      "command": "uvx",
+      "args": ["ultimate-brain-mcp"],
+      "env": {
+        "NOTION_INTEGRATION_SECRET": "secret_...",
+        "UB_TASKS_DS_ID": "...",
+        "UB_PROJECTS_DS_ID": "...",
+        "UB_NOTES_DS_ID": "...",
+        "UB_TAGS_DS_ID": "...",
+        "UB_GOALS_DS_ID": "..."
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+### Tasks (6)
+- `search_tasks` — Filter by status, project, priority, due date, My Day
+- `create_task` — Create with name, status, due, priority, project, labels
+- `update_task` — Patch any task properties
+- `complete_task` — Mark done with recurrence handling
+- `get_my_day` — My Day tasks sorted by priority
+- `get_inbox_tasks` — Unprocessed tasks needing triage
+
+### Projects (4)
+- `search_projects` — Filter by status, tag
+- `get_project_detail` — Properties + task breakdown + recent notes
+- `create_project` — Create with name, status, deadline, tag, goal
+- `update_project` — Patch project properties
+
+### Notes (4)
+- `search_notes` — Filter by type, project, tag, favorite, date
+- `get_note_content` — Properties + page body as plain text
+- `create_note` — Create with type, project, tags, URL
+- `update_note` — Patch note properties
+
+### Tags (3)
+- `search_tags` — Filter by PARA type
+- `create_tag` — Create with name, type, parent
+- `update_tag` — Patch tag properties
+
+### Goals (4)
+- `search_goals` — Filter by status
+- `get_goal_detail` — Properties + linked projects
+- `create_goal` — Create with name, status, deadline
+- `update_goal` — Patch goal properties
+
+### Cross-Cutting (2)
+- `daily_summary` — My Day, overdue, inbox, active projects/goals
+- `archive_item` — Archive any UB item
+
+### Generic (3)
+- `query_database` — Query any secondary database
+- `get_page` — Fetch any page by ID
+- `update_page` — Update any page properties
+
+## Development
+
+```bash
+uv run pytest tests/
+uv run mcp dev src/ultimate_brain_mcp/server.py
+```

ultimate_brain_mcp-0.1.0/README.md

@@ -0,0 +1,104 @@
+# MCP Server for Ultimate Brain
+
+An MCP server for managing Thomas Frank's Ultimate Brain Notion system. Provides 26 workflow-oriented tools for Tasks, Projects, Notes, Tags, and Goals using the PARA methodology.
+
+## Setup
+
+1. Create a [Notion integration](https://www.notion.so/my-integrations) and share your Ultimate Brain databases with it.
+
+2. Auto-discover data source IDs:
+
+```bash
+uv run python setup_dev.py
+```
+
+3. Run the server:
+
+```bash
+uv run ultimate-brain-mcp
+```
+
+## Claude Code Integration
+
+```bash
+claude mcp add ultimate-brain \
+  -e NOTION_INTEGRATION_SECRET=secret_... \
+  -e UB_TASKS_DS_ID=... \
+  -e UB_PROJECTS_DS_ID=... \
+  -e UB_NOTES_DS_ID=... \
+  -e UB_TAGS_DS_ID=... \
+  -e UB_GOALS_DS_ID=... \
+  -- uvx ultimate-brain-mcp
+```
+
+## Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ultimate-brain": {
+      "command": "uvx",
+      "args": ["ultimate-brain-mcp"],
+      "env": {
+        "NOTION_INTEGRATION_SECRET": "secret_...",
+        "UB_TASKS_DS_ID": "...",
+        "UB_PROJECTS_DS_ID": "...",
+        "UB_NOTES_DS_ID": "...",
+        "UB_TAGS_DS_ID": "...",
+        "UB_GOALS_DS_ID": "..."
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+### Tasks (6)
+- `search_tasks` — Filter by status, project, priority, due date, My Day
+- `create_task` — Create with name, status, due, priority, project, labels
+- `update_task` — Patch any task properties
+- `complete_task` — Mark done with recurrence handling
+- `get_my_day` — My Day tasks sorted by priority
+- `get_inbox_tasks` — Unprocessed tasks needing triage
+
+### Projects (4)
+- `search_projects` — Filter by status, tag
+- `get_project_detail` — Properties + task breakdown + recent notes
+- `create_project` — Create with name, status, deadline, tag, goal
+- `update_project` — Patch project properties
+
+### Notes (4)
+- `search_notes` — Filter by type, project, tag, favorite, date
+- `get_note_content` — Properties + page body as plain text
+- `create_note` — Create with type, project, tags, URL
+- `update_note` — Patch note properties
+
+### Tags (3)
+- `search_tags` — Filter by PARA type
+- `create_tag` — Create with name, type, parent
+- `update_tag` — Patch tag properties
+
+### Goals (4)
+- `search_goals` — Filter by status
+- `get_goal_detail` — Properties + linked projects
+- `create_goal` — Create with name, status, deadline
+- `update_goal` — Patch goal properties
+
+### Cross-Cutting (2)
+- `daily_summary` — My Day, overdue, inbox, active projects/goals
+- `archive_item` — Archive any UB item
+
+### Generic (3)
+- `query_database` — Query any secondary database
+- `get_page` — Fetch any page by ID
+- `update_page` — Update any page properties
+
+## Development
+
+```bash
+uv run pytest tests/
+uv run mcp dev src/ultimate_brain_mcp/server.py
+```