Amazing-Marvin-MCP

Overview

This is a Model Context Protocol server that bridges Amazing Marvin, a productivity application, with AI assistants. It enables AI systems to access and interact with tasks, projects, and categories from Amazing Marvin through the MCP protocol. The server exposes various tools for retrieving daily overviews, tasks, projects, due items, and creating or marking tasks as done. It's designed to help users get personalized productivity assistance based on their actual data rather than generic advice.

Try asking AI

After installing, here are 3 things you can ask your AI assistant:

• get_daily_productivity_overview

  Get a comprehensive daily view including today's tasks, overdue items, completed tasks, and planning insights

  Try:What should I focus on today?Try:Show me my productivity summary for today
• get_tasks

  Retrieve today's scheduled tasks only

  Try:What tasks do I have today?Try:Show me my scheduled tasks for today
• get_projects

  Get all projects from your Amazing Marvin account

  Try:Show me my projectsTry:List all my current projects
• get_categories

  Retrieve all categories in your Amazing Marvin setup

  Try:What categories do I have?Try:Show me my task categories
• get_due_items

  Get overdue and due items only

  Try:What's overdue?Try:Show me items that are due today
• get_child_tasksget_child_tasks(parent_id: str, recursive: bool = False)

  Retrieve subtasks of a parent task or project

  Try:Show me the subtasks for project XTry:What tasks are under parent task Y
• create_task

  Create a new task in Amazing Marvin

  Try:Create a new task for XTry:Add a task called 'Prepare presentation'
• mark_task_done

  Mark an existing task as completed

  Try:Mark task Y as doneTry:I've finished this task
• start_time_tracking

  Start tracking time on a specific task

  Try:Start tracking time on this taskTry:Begin time tracking for task X

Comparable tools

Installation

npx -y @smithery/cli install @bgheneti/amazing-marvin-mcp --client claude

pip install amazing-marvin-mcp

{
  "mcpServers": {
    "amazing-marvin": {
      "command": "python",
      "args": ["-m", "amazing_marvin_mcp"],
      "env": {
        "AMAZING_MARVIN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Compare Amazing-Marvin-MCP with