abhinavkonagala/marvin-mcp-server

Amazing Marvin MCP Server

A Model Context Protocol (MCP) server that integrates Amazing Marvin task management with Claude Desktop.

Features

• 📋 View today's tasks and overdue items
• ✅ Create, complete, and update tasks
• 📁 List and manage projects
• 🔍 Search tasks
• 📊 View productivity statistics

Prerequisites

• Docker Desktop
• Claude Desktop
• Amazing Marvin account with API access

Installation

1. Clone the repository

git clone https://github.com/abhinavkonagala/marvin-mcp-server.git
cd marvin-mcp-server

2. Build Docker image

docker build -t marvin-mcp-server .

3. Get your Amazing Marvin API tokens

• Log into Amazing Marvin
• Go to Settings → API & Webhooks
• Copy your API Token and Full Access Token

4. Configure Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "marvin": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "MARVIN_API_TOKEN=your-token-here",
        "-e", "MARVIN_FULL_ACCESS_TOKEN=your-full-token-here",
        "marvin-mcp-server:latest"
      ]
    }
  }
}

5. Restart Claude Desktop

Available Tools

• get_today_tasks - Fetch today's scheduled and overdue tasks
• create_task - Create new tasks with optional due date and project
• complete_task - Mark tasks as completed
• get_projects - List all active projects
• search_tasks - Search tasks by title or content
• update_task - Update task properties
• get_productivity_stats - View productivity statistics

Usage Examples

In Claude Desktop:

• "What tasks do I have today?"
• "Create a task to review budget due next Friday"
• "Show my productivity stats for the last week"
• "Mark task [ID] as complete"

Security Notes

⚠️ Never commit your API tokens! Always use environment variables or Docker secrets.

License

MIT

Author

Abhinav Konagala

Contributing

Pull requests welcome! Please ensure you don't commit any API tokens or sensitive data.