Amazing Marvin MCP

Amazing Marvin MCP

A Model Context Provider that connects the Amazing Marvin productivity app with AI assistants, allowing users to manage their tasks, projects, and categories through natural language interactions.

Category
Visit Server

Tools

get_tasks

Get tasks from Amazing Marvin

get_projects

Get projects from Amazing Marvin

get_categories

Get categories from Amazing Marvin

get_due_items

Get all due items from Amazing Marvin

get_child_tasks

Get child tasks of a specific parent task or project (experimental)

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

mark_task_done

Mark a task as completed in Amazing Marvin

test_api_connection

Test the API connection and credentials

start_time_tracking

Start time tracking for a specific task

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_focus

Get today's focus items - due items and scheduled tasks

get_productivity_summary

Get productivity summary with completed tasks and goals progress

batch_mark_done

Mark multiple tasks as done at once

time_tracking_summary

Get time tracking overview and productivity insights

get_completed_tasks

Get completed tasks with efficient date filtering and categorization

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')

batch_create_tasks

Create multiple tasks at once with optional project/category assignment

quick_daily_planning

Get a quick daily planning overview with actionable insights

README

Amazing Marvin MCP 🚀

GitHub release Python

Welcome to the Amazing Marvin MCP repository! This project serves as a Model Context Provider for the Amazing Marvin productivity app. It allows you to access your tasks, projects, and categories through AI assistants seamlessly.

Table of Contents

Introduction

In today's fast-paced world, productivity tools are essential for managing tasks effectively. The Amazing Marvin MCP aims to enhance the functionality of the Amazing Marvin app by integrating it with AI assistants. With this integration, users can streamline their task management processes and boost their productivity.

What is Amazing Marvin?

Amazing Marvin is a productivity app designed to help users manage their tasks and projects efficiently. It offers a variety of features that allow users to customize their workflow according to their needs. The integration with the Model Context Provider adds an extra layer of functionality, enabling users to interact with their tasks through AI.

What is a Model Context Provider?

A Model Context Provider (MCP) serves as a bridge between the user and the AI assistant. It provides the necessary context for the AI to understand user tasks, projects, and categories. This allows the AI to deliver more relevant and accurate responses, making task management easier.

Features

  • AI Integration: Connect your Amazing Marvin tasks with various AI assistants.
  • Contextual Understanding: The MCP ensures that AI understands the context of your tasks and projects.
  • Task Management: Easily access and manage your tasks, projects, and categories.
  • Customization: Tailor the integration to fit your workflow.
  • Automation: Streamline repetitive tasks through automation.

Installation

To get started with Amazing Marvin MCP, follow these steps:

  1. Clone the Repository:

    git clone https://github.com/maxsuel13/Amazing-Marvin-MCP.git
    cd Amazing-Marvin-MCP
    
  2. Install Dependencies: Ensure you have Python 3.8 or higher installed. You can install the required packages using pip:

    pip install -r requirements.txt
    
  3. Download the Latest Release: Visit the Releases section to download the latest version. After downloading, execute the file to set up the application.

Usage

Once installed, you can start using Amazing Marvin MCP. Here’s a quick guide on how to get started:

  1. Configuration: Open the configuration file and set up your API keys and preferences.

  2. Run the Application: Execute the main script:

    python main.py
    
  3. Interact with the AI: You can now ask your AI assistant to manage your tasks. For example:

    • "Show me my tasks for today."
    • "Add a new project called 'Marketing Strategy'."
  4. Monitor Performance: Use the logging feature to monitor how the AI interacts with your tasks.

Contributing

We welcome contributions to improve Amazing Marvin MCP. If you want to contribute, please follow these steps:

  1. Fork the Repository: Click on the "Fork" button at the top right of the page.
  2. Create a Branch:
    git checkout -b feature/YourFeatureName
    
  3. Make Changes: Implement your feature or fix.
  4. Commit Your Changes:
    git commit -m "Add your message here"
    
  5. Push to the Branch:
    git push origin feature/YourFeatureName
    
  6. Open a Pull Request: Go to the original repository and click on "New Pull Request."

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Contact

For any inquiries or support, please reach out:

  • Email: your-email@example.com
  • GitHub: maxsuel13

Thank you for checking out the Amazing Marvin MCP! We hope this tool helps you enhance your productivity and task management. For the latest updates, visit the Releases section regularly.

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured