Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AMAZING_MARVIN_API_KEY | Yes | Your Amazing Marvin API token, found in Amazing Marvin → Settings → API. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tasks | {
"list": {},
"cancel": {},
"requests": {
"tools": {
"call": {}
},
"prompts": {
"get": {}
},
"resources": {
"read": {}
}
}
} |
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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_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_categories | Get categories from Amazing Marvin |
| 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_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. 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 | 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_labels | Get all labels from Amazing Marvin |
| get_goals | Get all goals from Amazing Marvin |
| get_account_info | Get account information from Amazing Marvin |
| get_currently_tracked_item | Get currently tracked item from Amazing Marvin |
| create_task | 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_task_done | 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_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. |
| 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 |
| get_time_tracks | Get time tracking data for specific tasks |
| claim_reward_points | Claim reward points for completing a task |
| get_kudos_info | Get kudos and achievement information |
| create_project | Create a new project in Amazing Marvin |
| create_project_with_tasks | Create a project with multiple tasks at once |
| get_project_overview | Get comprehensive overview of a project including tasks and progress |
| 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). |
| batch_create_tasks | Create multiple tasks at once with optional project/category assignment |
| batch_mark_done | Mark multiple tasks as done at once |
| 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(). |
| 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_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_date | Get completed tasks for a specific date using efficient API filtering Args: date: Date in YYYY-MM-DD format (e.g., '2025-06-13') |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |