Amazing Marvin

You connect Amazing Marvin to your preferred MCP-compatible AI client so your assistant can see and help with your actual Marvin data. This integration keeps your data local to your machine while enabling personalized, context-aware productivity coaching directly from your AI chats.

How to use

Once you have the MCP server running, your AI client can query Marvin data and perform actions through the MCP interface. You can ask your AI for a daily productivity overview, see project progress, pull overdue items, start or stop time tracking, and create or complete tasks. The AI will surface results that reflect your real Marvin setup, including tasks, deadlines, categories, and goals. Use natural language prompts like “What tasks do I have today?”, “Show me my overdue items,” or “Start time tracking on this task.” You can also ask for planning assistance, such as a focused daily plan or a project overview, and the AI will respond with concrete, Marvin-backed details.

How to install

# Prerequisites: Python 3.10+, access to Amazing Marvin API
# Install the MCP server (stdio) via pip
pip install amazing-marvin-mcp

# Run the MCP server locally (stdio)
python -m amazing_marvin_mcp

# Ensure your API key is available to the process, for example:
export AMAZING_MARVIN_API_KEY="your-api-key-here"

Additional sections

Configuration details, security considerations, and troubleshooting are included below to help you keep the integration running smoothly.

Available tools

get_daily_productivity_overview

PRIMARY read operation that provides a comprehensive daily view including today's tasks, overdue items, completed tasks, and planning insights.

get_tasks

Fetch today's scheduled items only.

get_projects

Retrieve all projects.

get_categories

Retrieve all categories.

get_due_items

Return overdue and due items.

get_child_tasks

Get subtasks of a given parent task or project, with an optional recursive flag.

get_all_tasks

Search and return all tasks with an optional label filter.

get_labels

Fetch all task labels.

get_goals

Retrieve goals and objectives.

get_account_info

Return account details.

get_completed_tasks

Get completed tasks with date categorization (default past 7 days).

get_completed_tasks_for_date

Get completed tasks for a specific date.

get_productivity_summary_for_time_range

Flexible analytics over a specified time window.

get_currently_tracked_item

Identify the task currently being time-tracked.

create_task

Create a new task with optional project/category, due date, and notes.

mark_task_done

Mark a task as completed.

create_project

Create a new project.

start_time_tracking

Begin time tracking for a task.

stop_time_tracking

End time tracking for a task.

batch_mark_done

Complete multiple tasks in one operation.

batch_create_tasks

Create multiple tasks in a single request.

claim_reward_points

Claim kudos or reward points tied to an item/date.

get_kudos_info

Retrieve reward system and kudos information.

test_api_connection

Verify connectivity to the Marvin API.

get_project_overview

Provide analytics for a specific project.

get_daily_focus

Return daily prioritized items.

get_productivity_summary

General performance metrics.

time_tracking_summary

Time tracking analytics.

quick_daily_planning

Assist with fast daily planning.

create_project_with_tasks

Create a project and attach initial tasks.

get_time_tracks

Fetch time tracking history for given tasks.