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.
推荐服务器
Baidu Map
百度地图核心API现已全面兼容MCP协议,是国内首家兼容MCP协议的地图服务商。
Playwright MCP Server
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。
Magic Component Platform (MCP)
一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。
Audiense Insights MCP Server
通过模型上下文协议启用与 Audiense Insights 账户的交互,从而促进营销洞察和受众数据的提取和分析,包括人口统计信息、行为和影响者互动。
VeyraX
一个单一的 MCP 工具,连接你所有喜爱的工具:Gmail、日历以及其他 40 多个工具。
graphlit-mcp-server
模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外,还可以将任何内容(从 Slack 到 Gmail 再到播客订阅源)导入到 Graphlit 项目中,然后从 MCP 客户端检索相关内容。
Kagi MCP Server
一个 MCP 服务器,集成了 Kagi 搜索功能和 Claude AI,使 Claude 能够在回答需要最新信息的问题时执行实时网络搜索。
e2b-mcp-server
使用 MCP 通过 e2b 运行代码。
Neon MCP Server
用于与 Neon 管理 API 和数据库交互的 MCP 服务器
Exa MCP Server
模型上下文协议(MCP)服务器允许像 Claude 这样的 AI 助手使用 Exa AI 搜索 API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时的网络信息。