mit-mcp

markgx/mit-mcp

3.2

If you are the rightful owner of mit-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MIT-MCP is a Model Context Protocol server designed to help users manage their daily Most Important Tasks efficiently.

Tools

  1. list_mits

    List MITs for today or a specific date.

  2. create_mit

    Create a new MIT for today or a future date.

  3. update_mit

    Update an existing MIT.

  4. delete_mit

    Delete a MIT.

Most Important Tasks (MIT) MCP Server

MIT-MCP is a Model Context Protocol (MCP) server that enables AI agents to help you manage your daily Most Important Tasks.

Features

  • Daily Task Limits: Enforces a configurable 3-task limit to maintain focus
  • Date-Based Organization: Manage tasks by date
  • Persistent Storage: SQLite database saves your task data

Configuration

Environment Variables

  • DATABASE_PATH: Custom database location (optional, defaults to platform-specific data directory)
  • MAX_MITS_PER_DAY: Maximum tasks per day (optional, defaults to 3)

Default Database Locations

  • Linux: ~/.local/share/mit-mcp/data.db
  • macOS: ~/Library/Application Support/mit-mcp/data.db
  • Windows: %LOCALAPPDATA%\mit-mcp\data.db

MCP Client Configuration

Add to your MCP client configuration (e.g., Claude Desktop):

{
  "servers": {
    "mit-mcp": {
      "command": "npx",
      "args": ["-y", "@markgx/mit-mcp"]
    }
  }
}

Available Tools

list_mits

List MITs with flexible date range and filters.

Parameters:

  • startDate (optional): Start of date range in YYYY-MM-DD format
  • endDate (optional): End of date range in YYYY-MM-DD format
  • completed (optional): Filter by completion status (true/false)
  • limit (optional): Maximum number of results (1-10000, defaults to 100)

Notes:

  • When no dates are provided, returns today's MITs
  • Results are ordered by date DESC, then order ASC

Examples:

// Get MITs for a specific date range
{
  "arguments": {
    "startDate": "2024-12-01",
    "endDate": "2024-12-31"
  }
}

// Get completed MITs for today
{
  "arguments": {
    "completed": true
  }
}

create_mit

Create a new MIT for today or a future date.

Parameters:

  • description (required): Task description
  • order (optional): Display order (auto-calculated if not provided)
  • date (optional): Target date in YYYY-MM-DD format (defaults to today)

Example:

{
  "arguments": {
    "description": "Buy kibble for Ace",
    "order": 1
  }
}

update_mit

Update an existing MIT.

Parameters:

  • id (required): MIT identifier
  • description (optional): New description
  • completed (optional): Completion status
  • order (optional): New display order
  • date (optional): New date (must be today or future)

Example:

{
  "arguments": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "completed": true
  }
}

delete_mit

Delete a MIT.

Parameters:

  • id (required): MIT identifier

Example:

{
  "arguments": {
    "id": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Usage Examples

Starting Your Day

User: What are my MITs for today?
Assistant: Let me check your Most Important Tasks for today...

[Calls list_mits tool]

You have 2 MITs for today:
1. ā˜ Buy kibble for Ace
2. ā˜ Walk Ace to the park

You have room for 1 more MIT today. What's the most important thing you need to accomplish?

Adding a Task

User: Add "Give Ace a bath" as my top MIT
Assistant: I'll add that as your top priority MIT for today.

[Calls create_mit tool with order: 1]

āœ“ Added "Give Ace a bath" as your #1 MIT for today.
You now have 3 MITs (your daily limit) - time to focus on execution!

Completing Tasks

User: I gave Ace a bath
Assistant: Excellent! Let me mark that as complete.

[Calls update_mit tool with completed: true]

āœ“ "Give Ace a bath" is now complete!
You have 2 remaining MITs for today. Keep the momentum going!

License

MIT License