# Amazing Marvin MCP MCP > Amazing Marvin lets your agent manage tasks, projects, and time tracking without you opening the web app. It connects directly to your Amazing Marvin account via MCP, letting your AI client add new tasks, organize categories, update project status, and track working time instantly from natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** amazing-marvin, todo, task-management, time-tracking, productivity, mcp, ai-agents ## Description This MCP gives your agent full control over your daily planning in Amazing Marvin. Instead of jumping into your task manager every time you want to check off a quick item or start tracking deep work, you just talk to your AI client. Your agent can now build out new categories and projects for structured organization. Need to log some time? Tell it which task needs attention, and the MCP starts tracking time automatically. It even retrieves everything scheduled for today so your agent has an immediate overview when you ask about your day. You'll never have to leave your chat window just to update a due date or mark something as done again. Connecting this via Vinkius gives you access to Marvin’s entire set of tools, letting you keep all your planning and time logging in one place. ## Tools ### add_category Adds a completely new organizational category within Amazing Marvin. ### add_project Creates a structured container for a large body of work or initiative. ### add_task Adds a specific task, optionally linking it to a parent project and setting its scheduled date. ### get_children Retrieves all tasks and sub-categories that belong under a specified category or project ID. ### get_today_items Fetches an immediate list of every task scheduled for the current day in Amazing Marvin. ### mark_done Changes a specific task's status to completed within Amazing Marvin. ### start_tracking Initiates time tracking for an existing task, beginning your recorded work session. ### stop_tracking Ends the currently running time tracker and logs the duration of your work period. ### update_task Modifies an existing task's details, such as its title, scheduled date, or completion status. ## Prompt Examples **Prompt:** ``` What do I have scheduled for today in Amazing Marvin? ``` **Response:** ``` You have 3 tasks scheduled for today: 1. Reply to emails, 2. Update the staging server, 3. Buy groceries. ``` **Prompt:** ``` Add a new task to call the client and schedule it for tomorrow. ``` **Response:** ``` I've added the task 'Call the client' and scheduled it for tomorrow. ``` **Prompt:** ``` Start tracking time for the 'Database migration' task. ``` **Response:** ``` Time tracking has started for the 'Database migration' task. ``` ## Capabilities ### Schedule and Update Tasks Your agent can add new tasks, change their title or due date, and mark them as completed. ### Manage Projects and Organization You can build out new project structures and custom categories to keep your workspace tidy. ### Time Tracking Management The agent starts or stops time tracking directly against a specific task, keeping accurate logs of your work hours. ### Review Daily Schedule You can request an immediate list of all tasks scheduled for the current day. ## Use Cases ### End-of-Week Wrap Up A developer finishes a large feature. Instead of manually going into Marvin and ticking off 15 small tasks, they just tell their agent to mark them done. The agent runs `mark_done` across the board and logs the final time spent. ### Immediate Planning Session A manager needs an agenda for a meeting tomorrow. They ask their agent, 'What tasks are due today?' The agent calls `get_today_items`, providing an immediate briefing without requiring the manager to open the dashboard. ### Scope Creep Containment A project gets a new dependency. Instead of starting a whole new file, the PM asks their agent to `add_project` and create a specific category for the new workstream, keeping it organized. ### Client Work Logging An engineer works on client X's database migration. They tell their agent to start tracking time for that task. When they finish, the agent runs `stop_tracking`, ensuring perfect billable hours are recorded. ## Benefits - Stop context switching. Instead of leaving the chat to update a task, tell your agent what needs changing. It handles `update_task` instantly. - Keep track of your hours accurately. Use the MCP to start tracking for any task when you begin work and stop it when you're done; no manual time sheet entry needed. - Organize on demand. When a new initiative pops up, just ask your agent to `add_project` or create a clean category using `add_category`. - Never miss a deadline overview. Asking for today’s schedule runs the `get_today_items` tool and gives you an instant list of what’s due. - Project visibility improves when your agent can pull all related items, running `get_children` to show everything nested under a main project. ## How It Works The bottom line is, after connecting it once, your agent treats Amazing Marvin like an extension of its own conversational memory. 1. First, get your unique token from your Amazing Marvin API settings and copy it. 2. Next, input that token into the Vinkius environment to link your accounts. 3. Finally, tell your AI client exactly what you need done—for instance, 'What do I have scheduled for today?'—and the MCP executes the command. ## Frequently Asked Questions **How do I check what's due today using Amazing Marvin MCP?** You run `get_today_items`. Your agent calls this tool and gives you a clean list of every single task scheduled for the current day, so you know exactly where to start. **Can I update an existing task using Amazing Marvin MCP?** Yes. You use `update_task` by telling your agent what change you want—like changing a due date or modifying the title—and it handles updating the record for you. **What happens if I start tracking time but forget to stop it using Amazing Marvin MCP?** You simply tell your agent to `stop_tracking`. It ends the session, logs the total elapsed time, and prevents inaccurate data from remaining in your records. **Do I need to use add_project before adding tasks with Amazing Marvin MCP?** It helps keep things clean. You should run `add_project` first to create the top-level container, and then you can confidently use `add_task` knowing where that task belongs. **How do I use the `get_children` tool to list all tasks or sub-categories within a specific project?** It fetches a complete list of items. You provide an ID, and it returns everything nested beneath that item. This lets you map out your entire workspace structure easily. **What information does the `mark_done` tool require to correctly mark a task as completed?** You must provide the unique ID of the task. The tool then updates its status, ensuring it appears in your completed items list and is removed from active views. **When I use `add_category`, do I need to specify a parent project or category ID?** No, you can typically create top-level categories without an ID. If you do provide one, the new category will nest under that specific existing parent item. **What happens if I call `stop_tracking` when no time tracker is currently running?** The system handles this gracefully. It returns a clear message or an error code stating there's no active session to stop, so your data remains safe. **Can the AI Agent start a time tracker for a specific task?** Yes! The agent can start and stop the time tracker for any task if you provide the task ID. **Is it possible to assign tasks to specific dates?** Yes, the agent can schedule tasks to specific days by passing the 'day' parameter (e.g., '2024-10-31'). **Does the agent manage both categories and projects?** Absolutely. It can create new categories or projects and organize them by assigning parent IDs.