batch_create_tasks
Create multiple tasks at once with optional project/category assignment
LABSCO SUMMARY
One call opens the day; batch writes close it.
The tools cross-reference each other about which to reach for, and they consistently point at get_daily_productivity_overview as the primary daily call — so a morning check is one round trip rather than four separate lists stitched together. The writes are where the time goes back: batch_create_tasks and batch_mark_done handle the many-small-items case that would otherwise be one call each. get_child_tasks carries an experimental marker in its own description.
What it is
A task-and-time server over an Amazing Marvin account, built around one consolidated daily view with narrower reads underneath it.
What you get
- get_daily_productivity_overview, which returns today's scheduled tasks, overdue items, completed items and planning insights in a single call
- Narrower reads when you want one slice only: today's scheduled tasks, overdue and due items, or every task across projects with an optional label filter
- Structure: projects, categories, labels, goals, a project overview with progress, and child tasks of a parent with a recursive option
- Writes on tasks: create one, create many with batch_create_tasks, mark done singly or with batch_mark_done, and create a project together with its tasks in one call
- Time tracking started and stopped per task, the currently tracked item, raw time tracks for given task IDs, and a tracking summary
- Completion history over the past 7 days, for one named date, or across a custom range
- Reward points claimed against a completed task, and the kudos and achievement record
Requirements
An Amazing Marvin account. The tools reach it through its API — test_api_connection exists to confirm that setup, returning OK or the error details.
Setup effort
One command plus a key — pip install amazing-marvin-mcp, then supply credentials
USE CASES
01
Working out what today actually looks like
One call returns today's scheduled tasks, what is overdue, what is already done and the planning insights together. The narrower getters are there when you want the overdue list or today's list on its own.
02
Standing up a new project and its first week of work
Create the project together with its task titles in one call, add the rest in a batch against the project or category id, then read the overview back to check what landed and how far along it is.
03
Finding out where the hours went
Tracking starts and stops against a task id rather than a timer in the UI, so the model can open and close it around the work. The summary and the raw tracks answer the question afterwards.
04
Writing the weekly review
Completed work comes back three ways: the past 7 days with categorisation, one specific date, or a custom range set by start and end date. Enough to answer what shipped without opening the app.
28 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
batch_mark_done
Mark multiple tasks as done at once
claim_reward_points
Claim reward points for completing a task
create_project
Create a new project in Amazing Marvin
create_project_with_tasks
Create a project with multiple tasks at once
create_task
Create a new task in Amazing Marvin.
get_account_info
Get account information from Amazing Marvin
get_all_tasks
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.
get_categories
Get categories from Amazing Marvin
get_child_tasks
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.
get_completed_tasks
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_completed_tasks_for_date
Get completed tasks for a specific date using efficient API filtering
get_currently_tracked_item
Get currently tracked item from Amazing Marvin
get_daily_productivity_overview
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).
get_due_items
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_goals
Get all goals from Amazing Marvin
get_kudos_info
Get kudos and achievement information
get_labels
Get all labels from Amazing Marvin
get_productivity_summary_for_time_range
Get a comprehensive productivity summary for a specified time range
get_project_overview
Get comprehensive overview of a project including tasks and progress
get_projects
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_tasks
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_time_tracks
Get time tracking data for specific tasks
mark_task_done
Mark a task as completed in Amazing Marvin.
start_time_tracking
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
Stop time tracking for a specific task
test_api_connection
Test the API connection and credentials.
Use when troubleshooting connection issues or verifying API setup. Returns "OK" if successful or error details if failed.
time_tracking_summary
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().
BEFORE YOU INSTALL
What to know first
Tools you get
28 tools when we connected. get_daily_focus, get_productivity_summary and quick_daily_planning are listed in the documentation but not available. Nine tools write, such as create_task and mark_task_done; none delete or edit.
Requires
- python on PATH
- AMAZING_MARVIN_API_KEY in your environment
Where it runs
All 4 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 28 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install amazing-marvin-mcpMCP Clients
Cursor, Windsurf, Claude Desktop
JSON
{
"mcpServers": {
"amazing-marvin": {
"command": "python",
"args": [
"-m",
"amazing_marvin_mcp"
],
"env": {
"AMAZING_MARVIN_API_KEY": "<YOUR_AMAZING_MARVIN_API_KEY>"
}
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"amazing-marvin": {
"command": "python",
"args": [
"-m",
"amazing_marvin_mcp"
],
"env": {
"AMAZING_MARVIN_API_KEY": "<YOUR_AMAZING_MARVIN_API_KEY>"
}
}
}
}
