Back to Browse

Reclaim MCP Server

Developer ToolsUse Caution4.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

MCP server for Reclaim.ai - calendar, tasks, habits, and focus time management

About

MCP server for Reclaim.ai - calendar, tasks, habits, and focus time management

Security Report

4.0
Use Caution4.0High Risk

Valid MCP server (0 strong, 3 medium validity signals). 6 known CVEs in dependencies (1 critical, 3 high severity) Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

4 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-universalamateur-reclaim-mcp-server": {
      "args": [
        "reclaim-mcp-server"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Reclaim.ai MCP Server (UNOFFICIAL)

PyPI Downloads Python License: MIT

UNOFFICIAL – Not affiliated with Reclaim.ai. Uses their public API , use at your own risk.

Control your Reclaim.ai calendar, tasks, and habits from AI assistants via MCP.

What You Can Do

"Create a 2-hour task to review the Q1 budget, due Friday"
"What's on my calendar tomorrow?"
"Mark my morning workout habit as done"
"Show me my productivity stats for last week"
"Start a focus block for the next 90 minutes"

40 tools across tasks, calendar, habits, focus time, and analytics. See docs/TOOLS.md for complete reference.

Quick Start

1. Get your API key: https://app.reclaim.ai/settings/developer

2. Install

pip install reclaim-mcp-server

3. Configure Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

   {
     "mcpServers": {
       "reclaim": {
         "command": "uvx",
         "args": ["reclaim-mcp-server"],
         "env": { "RECLAIM_API_KEY": "your_key_here" }
       }
     }
   }

4. Restart Claude Desktop

Installation Options

MethodCommand
uvx (recommended)uvx reclaim-mcp-server
pippip install reclaim-mcp-server
Smitherynpx -y @smithery/cli install universalamateur/reclaim-mcp-server --client claude
Dockerdocker pull universalamateur/reclaim-mcp-server
Sourcegit clone https://gitlab.com/universalamateur1/reclaim-mcp-server.git && cd reclaim-mcp-server && poetry install

Registries: PyPI · Smithery · Glama · GitHub · GitLab

Tool Profiles

Limit exposed tools via RECLAIM_TOOL_PROFILE:

ProfileToolsUse Case
minimal20Basic task/habit management
standard32Daily productivity
full40All features (default)
{
  "mcpServers": {
    "reclaim": {
      "command": "uvx",
      "args": ["reclaim-mcp-server"],
      "env": {
        "RECLAIM_API_KEY": "your_key_here",
        "RECLAIM_TOOL_PROFILE": "standard"
      }
    }
  }
}

Other Configurations

{
  "mcpServers": {
    "reclaim": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "RECLAIM_API_KEY", "universalamateur/reclaim-mcp-server"],
      "env": { "RECLAIM_API_KEY": "your_key_here" }
    }
  }
}
{
  "mcpServers": {
    "reclaim": {
      "command": "/opt/homebrew/bin/poetry",
      "args": ["--directory", "/path/to/reclaim-mcp-server", "run", "reclaim-mcp-server"],
      "env": { "RECLAIM_API_KEY": "your_key_here" }
    }
  }
}

Note: Use --directory flag instead of cwd – Claude Desktop doesn't respect cwd.

Works with any MCP-compatible client. Generic stdio config:

{
  "command": "uvx",
  "args": ["reclaim-mcp-server"],
  "env": { "RECLAIM_API_KEY": "your_key_here" }
}

Troubleshooting

IssueSolution
"Invalid API key"Verify key at https://app.reclaim.ai/settings/developer
Rate limited (429)Server handles retries automatically; reduce request frequency
Tools not showingRestart Claude Desktop after config change
Docker ARM64 warningUse v0.8.1+ for native Apple Silicon support

Development

poetry install
poetry run pytest                    # Run tests
poetry run black src tests           # Format
poetry run mypy src                  # Type check
poetry run fastmcp dev src/reclaim_mcp/server.py  # Dev mode

Links

License

MIT – Falko Sieverding (@UniversalAmateur)


Built with FastMCP · Not affiliated with Reclaim.ai

Reviews

No reviews yet

Be the first to review this server!