src: refactored tools for more efficient use

Author: bgheneti

README.md

@@ -215,9 +215,10 @@ The MCP provides specific tools that your AI can use. Simply ask your AI to help
 
 | What you might ask | Tools the AI will use |
 |-------------------|----------------------|
-| *"What tasks do I have today?"* | `get_tasks()` |
+| *"What should I focus on today?"* | `get_daily_productivity_overview()` |
+| *"What tasks do I have today?"* | `get_daily_productivity_overview()` or `get_tasks()` |
 | *"Show me my projects"* | `get_projects()` |
-| *"What's overdue?"* | `get_due_items()` |
+| *"What's overdue?"* | `get_due_items()` or `get_daily_productivity_overview()` |
 | *"Create a new task for X"* | `create_task()` |
 | *"Mark task Y as done"* | `mark_task_done()` |
 | *"Start tracking time on this"* | `start_time_tracking()` |
@@ -426,41 +427,43 @@ pytest tests/        # Tests
 ```
 
 ### 🔄 Available Tools
-The MCP provides 27 comprehensive tools to AI assistants:
+The MCP provides 25 comprehensive tools to AI assistants:
 
 **📖 Read Operations:**
-- `get_tasks()` - Today's scheduled items
+- `get_daily_productivity_overview()` - **PRIMARY** comprehensive daily view (today's tasks, overdue, completed, planning insights)
+- `get_tasks()` - Today's scheduled items only
 - `get_projects()` - All projects
 - `get_categories()` - All categories
-- `get_due_items()` - Overdue/due items
-- `get_child_tasks()` - Subtasks
+- `get_due_items()` - Overdue/due items only
+- `get_child_tasks(parent_id: str, recursive: bool = False)` - Subtasks of a parent task/project
+- `get_all_tasks(label: str = None)` - Find all tasks with optional label filter (comprehensive search)
 - `get_labels()` - Task labels
 - `get_goals()` - Goals and objectives
 - `get_account_info()` - Account details
-- `get_completed_tasks()` - Completed items with date categorization
-- `get_completed_tasks_for_date()` - Completed items for specific date
-- `get_productivity_summary_for_time_range()` - Flexible productivity analytics (by days, or start/end dates)
+- `get_completed_tasks()` - Completed items with date categorization (defaults to past 7 days)
+- `get_completed_tasks_for_date(date: str)` - Completed items for specific date (YYYY-MM-DD format)
+- `get_productivity_summary_for_time_range(days: int = 7, start_date: str = None, end_date: str = None)` - Flexible productivity analytics
 - `get_currently_tracked_item()` - Active time tracking
 
 **✏️ Write Operations:**
-- `create_task()` - Create new tasks
-- `mark_task_done()` - Complete tasks
-- `create_project()` - Create new projects
-- `start_time_tracking()` - Begin time tracking
-- `stop_time_tracking()` - End time tracking
-- `batch_mark_done()` - Complete multiple tasks
-- `batch_create_tasks()` - Create multiple tasks
-- `claim_reward_points()` - Claim kudos points
+- `create_task(title: str, project_id: str = None, category_id: str = None, due_date: str = None, note: str = None)` - Create new tasks
+- `mark_task_done(item_id: str, timezone_offset: int = 0)` - Complete tasks
+- `create_project(title: str, project_type: str = "project")` - Create new projects
+- `start_time_tracking(task_id: str)` - Begin time tracking
+- `stop_time_tracking(task_id: str)` - End time tracking
+- `batch_mark_done(task_ids: list[str])` - Complete multiple tasks
+- `batch_create_tasks(task_list: list[str], project_id: str = None, category_id: str = None)` - Create multiple tasks
+- `claim_reward_points(points: int, item_id: str, date: str)` - Claim kudos points
 
 **🔧 Utility Operations:**
 - `test_api_connection()` - Verify API connectivity
-- `get_project_overview()` - Project analytics
+- `get_project_overview(project_id: str)` - Project analytics
 - `get_daily_focus()` - Daily priorities
 - `get_productivity_summary()` - Performance metrics
 - `time_tracking_summary()` - Time analytics
 - `quick_daily_planning()` - Planning assistance
-- `create_project_with_tasks()` - Project setup
-- `get_time_tracks()` - Time tracking history
+- `create_project_with_tasks(project_title: str, task_titles: list[str], project_type: str = "project")` - Project setup
+- `get_time_tracks(task_ids: list[str])` - Time tracking history
 
 ## 🤝 Contributing
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "amazing-marvin-mcp"
-version = "0.1.11"
+version = "1.0.0"
 description = "Amazing Marvin Model Context Provider"
 readme = "README.md"
 requires-python = ">=3.10"

src/amazing_marvin_mcp/analytics.py

@@ -250,6 +250,101 @@ def _process_date_data(
         range_summary["tasks_by_date"][date_str] = []
 
 
+def get_daily_productivity_overview(api_client: MarvinAPIClient) -> dict[str, Any]:
+    """Get comprehensive daily productivity overview combining focus, planning, and progress.
+
+    Consolidates functionality from get_productivity_summary, quick_daily_planning, and get_daily_focus
+    to reduce API calls from 11 to 5 for better performance.
+
+    Returns today's tasks, overdue items, completed items, planning insights, and productivity metrics.
+    """
+    today = DateUtils.get_today()
+
+    # Make efficient API calls (5 total instead of 11)
+    today_items = api_client.get_tasks()  # Today's scheduled items
+    due_items = api_client.get_due_items()  # Overdue/due items
+    today_completed = api_client.get_done_items()  # Today's completed items
+    projects = api_client.get_projects()  # For project context
+    goals = api_client.get_goals()  # For goal progress
+
+    # Combine pending items (removing duplicates)
+    all_pending_items = []
+    item_ids = set()
+
+    for item in today_items + due_items:
+        item_id = item.get("_id")
+        if item_id and item_id not in item_ids:
+            all_pending_items.append(item)
+            item_ids.add(item_id)
+
+    # Categorize pending items
+    high_priority = [
+        item for item in all_pending_items if item.get("priority") == "high"
+    ]
+    pending_projects = [
+        item for item in all_pending_items if item.get("type") == "project"
+    ]
+    pending_tasks = [
+        item for item in all_pending_items if item.get("type") != "project"
+    ]
+
+    # Calculate metrics
+    total_due = len(due_items)
+    total_scheduled = len(today_items)
+    total_completed = len(today_completed)
+    total_pending = len(all_pending_items)
+
+    # Generate planning suggestions
+    heavy_day_threshold = 5
+    suggestions = []
+    if total_due > 0:
+        suggestions.append(f"Focus on {total_due} overdue items first")
+    if total_scheduled > heavy_day_threshold:
+        suggestions.append("Consider rescheduling some tasks - you have a heavy day")
+    if total_scheduled == 0 and total_due == 0:
+        suggestions.append("Great! No urgent tasks today - time to work on your goals")
+    if total_completed > 0:
+        suggestions.append(
+            f"Good progress! You've completed {total_completed} items today"
+        )
+
+    # Productivity insights
+    productivity_note = (
+        f"You've completed {total_completed} items today!"
+        if total_completed > 0
+        else "No completed items yet today - keep going!"
+    )
+
+    return {
+        # Date and overview
+        "date": today,
+        "total_focus_items": total_pending + total_completed,
+        # Task breakdown
+        "pending_items": total_pending,
+        "completed_today": total_completed,
+        "overdue_items": total_due,
+        "scheduled_today": total_scheduled,
+        # Detailed task lists
+        "tasks": pending_tasks,
+        "projects": pending_projects,
+        "high_priority_items": high_priority,
+        "completed_items": today_completed,
+        "due_items": due_items[:5],  # Show first 5 due items
+        "today_items": today_items[:5],  # Show first 5 scheduled items
+        "all_pending_items": all_pending_items,
+        # Context and insights
+        "active_projects": len(projects),
+        "active_goals": len(goals),
+        "goals": goals,
+        "suggestions": suggestions,
+        "productivity_note": productivity_note,
+        "quick_summary": f"{total_due} due, {total_scheduled} scheduled, {total_completed} completed",
+        # Efficiency metrics
+        "api_calls_made": 5,
+        "efficiency_note": "Consolidated view using 5 API calls instead of 11 separate calls",
+    }
+
+
 def _calculate_statistics(range_summary: dict[str, Any]) -> None:
     """Calculate statistics from collected data and update range_summary."""
     if range_summary["daily_breakdown"]: