Amazing Marvin MCP Server

🚀 Amazing Marvin AI Assistant Integration

Connect your Amazing Marvin productivity system with AI assistants for smarter task management

📋 Table of Contents

• What is this?
• Quick Start (2 minutes)
• What can you do with this?
• Installation
• Configuration
• Usage Examples
• Troubleshooting
• FAQ
• Development
• Privacy & Security

🎯 What is this?

This connects your Amazing Marvin productivity system with AI assistants like Claude, Cursor, and others. Instead of manually copying your tasks and projects into chat, your AI assistant can see and help with your actual Amazing Marvin data.

✨ Key Benefits

• 🔄 Stay in sync - Your AI assistant always sees your current tasks, projects, and goals
• 📋 Smart help - Get personalized advice based on your actual workload and priorities
• ⚡ Save time - No more copy-pasting task lists or explaining your projects
• 🎯 Better focus - AI helps you identify what's most important right now
• 🔒 Private - Your data stays between Amazing Marvin and your AI assistant

⚡ Quick Start (2 minutes)

Step 1: Get your Amazing Marvin API key

1. Open Amazing Marvin → Settings → API
2. Enable the API and copy your token
3. Keep this handy! 🔑

Step 2: Install

Easy way (Smithery):

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

Paste the API key when prompted

Alternative (pip):

pip install amazing-marvin-mcp

Then add to your AI client config (see installation guide)

Step 3: Verify it's working

Ask your AI: "What tasks do I have today?"

🎉 That's it! Your AI can now see your Amazing Marvin data.

💡 What can you do with this?

Once connected, your AI assistant becomes your personal productivity coach with access to your real Amazing Marvin data:

📅 Daily Planning Help

"What should I focus on today?" - Get personalized recommendations based on your actual deadlines and priorities

"I'm feeling overwhelmed - what's most important?" - AI helps you cut through the noise and identify what really matters

🎯 Project Insights

"How is my website redesign project going?" - See progress, completed tasks, and what's left to do

"Show me everything related to client work this week" - Get organized views of your tasks by project or category

📊 Progress Tracking

"What did I accomplish this week?" - Review your productivity patterns and celebrate wins

"Which days am I most productive?" - Understand your patterns to plan better

⏰ Smart Scheduling

"What's overdue and needs attention?" - Never lose track of important deadlines

"Help me plan tomorrow based on what I have scheduled" - Get realistic daily plans that work

⏱️ Time Tracking

"Start tracking time on this task" - Seamlessly manage time tracking from your AI chat

"What have I been working on today?" - Review your time allocation and focus

Why this is better than generic productivity advice: Your AI sees your actual tasks, deadlines, and progress - so the help you get is personalized to your real situation, not generic tips.

Note: This covers most Amazing Marvin features, though some advanced customizations and strategies have limited API access.

📦 Installation

Option 1: Smithery (Easiest)

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

Visit Smithery Registry for other clients.

Option 2: Pip + Manual Config

Why choose this option:

• ✅ Works with any MCP-compatible AI client
• ✅ Easy to update: just pip install --upgrade amazing-marvin-mcp

Prerequisites

• ✅ Python 3.10+
• ✅ Claude Desktop, Cursor, Windsurf, VS Code, or another MCP client
• ✅ Amazing Marvin account with API access

Installation

# Install from PyPI (recommended)
pip install amazing-marvin-mcp

📱 Client Configuration