
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.
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 🚀
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:
-
Clone the Repository:
git clone https://github.com/maxsuel13/Amazing-Marvin-MCP.git cd Amazing-Marvin-MCP
-
Install Dependencies: Ensure you have Python 3.8 or higher installed. You can install the required packages using pip:
pip install -r requirements.txt
-
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:
-
Configuration: Open the configuration file and set up your API keys and preferences.
-
Run the Application: Execute the main script:
python main.py
-
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'."
-
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:
- Fork the Repository: Click on the "Fork" button at the top right of the page.
- Create a Branch:
git checkout -b feature/YourFeatureName
- Make Changes: Implement your feature or fix.
- Commit Your Changes:
git commit -m "Add your message here"
- Push to the Branch:
git push origin feature/YourFeatureName
- 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
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
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.
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.

VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
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.
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.

E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
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.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.