Amazing Marvin MCP

Get today's scheduled tasks only.

Use when you need only today's scheduled items without overdue or completed items. For comprehensive daily overview, use get_daily_productivity_overview() instead. For all tasks across projects, use get_all_tasks().

Get all projects (categories with type 'project').

Use when you need project list for organization or project selection. For detailed project analysis, use get_project_overview(project_id).

Get categories from Amazing Marvin

Get overdue and due tasks only (past due date).

Use when you need to focus specifically on urgent/overdue items. For complete daily view including today's tasks, use get_daily_productivity_overview().

Get child tasks of a specific parent task or project (experimental).

Use when you need to see subtasks within a project or parent task. Returns both tasks and sub-projects. Set recursive=True for deep hierarchy.

Args: parent_id: ID of the parent task or project recursive: If True, recursively get all descendants (can be expensive)

Note: This is an experimental endpoint and may not work for all parent types.

Get all tasks across all projects with optional label filtering (comprehensive search).

Use when you need to search/filter across your entire task system. For daily focus, use get_daily_productivity_overview() instead.

Args: label: Optional label name to filter by. If None, returns all tasks.

Note: This is a heavy operation that recursively searches all projects.

Get all labels from Amazing Marvin

Get all goals from Amazing Marvin

Get account information from Amazing Marvin

Get currently tracked item from Amazing Marvin

Create a new task in Amazing Marvin.

Args: title: Task title (required) project_id: Optional project ID to assign task to category_id: Optional category ID for organization due_date: Optional due date in YYYY-MM-DD format note: Optional task notes/description

For creating multiple tasks, use batch_create_tasks() instead. For creating a project with tasks, use create_project_with_tasks().

Mark a task as completed in Amazing Marvin.

Args: item_id: Task ID to mark as done timezone_offset: Timezone offset in minutes from UTC (e.g., -480 for PST)

For completing multiple tasks, use batch_mark_done(task_ids) instead.

Test the API connection and credentials.

Use when troubleshooting connection issues or verifying API setup. Returns "OK" if successful or error details if failed.

Start time tracking for a specific task.

Use when beginning focused work on a task to measure time spent. Check current tracking status with get_currently_tracked_item() or time_tracking_summary(). Stop tracking with stop_time_tracking(task_id).

Stop time tracking for a specific task

Get time tracking data for specific tasks

Claim reward points for completing a task

Get kudos and achievement information

Create a new project in Amazing Marvin

Create a project with multiple tasks at once

Get comprehensive overview of a project including tasks and progress

Get comprehensive daily productivity overview with today's tasks, overdue items, completed items, and planning insights.

Primary tool for daily planning and productivity. Consolidates multiple data sources efficiently. Use when you need a complete view of today's work situation.

For specific data only, use: get_tasks() (today's scheduled), get_due_items() (overdue), get_all_tasks() (comprehensive search), or get_completed_tasks() (recent completions).

Create multiple tasks at once with optional project/category assignment

Mark multiple tasks as done at once

Get time tracking overview and productivity insights.

Use when you need to check current time tracking status and get productivity metrics. For starting/stopping tracking, use start_time_tracking() or stop_time_tracking(). For daily productivity overview, use get_daily_productivity_overview().

Get completed tasks from past 7 days with efficient date filtering and categorization.

Use when you need to review recent accomplishments or productivity patterns. For specific date, use get_completed_tasks_for_date(date). For custom time ranges, use get_productivity_summary_for_time_range().

Get a comprehensive productivity summary for a specified time range

Args: days: Number of days to analyze from today backwards (default: 7 for weekly summary) Examples: 1 (today only), 7 (past week), 30 (past month) start_date: Start date in YYYY-MM-DD format (overrides days parameter) end_date: End date in YYYY-MM-DD format (defaults to today if start_date provided)

Examples: - get_productivity_summary_for_time_range(days=30) # Past 30 days - get_productivity_summary_for_time_range(start_date='2025-06-01', end_date='2025-06-10') - get_productivity_summary_for_time_range(start_date='2025-06-01') # June 1st to today

Get completed tasks for a specific date using efficient API filtering

Args: date: Date in YYYY-MM-DD format (e.g., '2025-06-13')