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
访问服务器

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.

推荐服务器

Baidu Map

Baidu Map

百度地图核心API现已全面兼容MCP协议,是国内首家兼容MCP协议的地图服务商。

官方
精选
JavaScript
Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。

官方
精选
本地
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

通过模型上下文协议启用与 Audiense Insights 账户的交互,从而促进营销洞察和受众数据的提取和分析,包括人口统计信息、行为和影响者互动。

官方
精选
本地
TypeScript
VeyraX

VeyraX

一个单一的 MCP 工具,连接你所有喜爱的工具:Gmail、日历以及其他 40 多个工具。

官方
精选
本地
graphlit-mcp-server

graphlit-mcp-server

模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外,还可以将任何内容(从 Slack 到 Gmail 再到播客订阅源)导入到 Graphlit 项目中,然后从 MCP 客户端检索相关内容。

官方
精选
TypeScript
Kagi MCP Server

Kagi MCP Server

一个 MCP 服务器,集成了 Kagi 搜索功能和 Claude AI,使 Claude 能够在回答需要最新信息的问题时执行实时网络搜索。

官方
精选
Python
e2b-mcp-server

e2b-mcp-server

使用 MCP 通过 e2b 运行代码。

官方
精选
Neon MCP Server

Neon MCP Server

用于与 Neon 管理 API 和数据库交互的 MCP 服务器

官方
精选
Exa MCP Server

Exa MCP Server

模型上下文协议(MCP)服务器允许像 Claude 这样的 AI 助手使用 Exa AI 搜索 API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时的网络信息。

官方
精选