universalamateur/reclaim-mcp-server

FreeNot checked

Reclaim.ai calendar integration with 40 tools for tasks, habits, focus time, scheduling links, and productivity analytics.

by universalamateur

GitHub Embed

About

Reclaim.ai calendar integration with 40 tools for tasks, habits, focus time, scheduling links, and productivity analytics.

README

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

Method	Command
uvx (recommended)	`uvx reclaim-mcp-server`
pip	`pip install reclaim-mcp-server`
Smithery	`npx -y @smithery/cli install universalamateur/reclaim-mcp-server --client claude`
Docker	`docker pull universalamateur/reclaim-mcp-server`
Source	`git 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:

Profile	Tools	Use Case
`minimal`	20	Basic task/habit management
`standard`	32	Daily productivity
`full`	40	All features (default)

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

Other Configurations

Docker

{
  "mcpServers": {
    "reclaim": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "RECLAIM_API_KEY", "universalamateur/reclaim-mcp-server"],
      "env": { "RECLAIM_API_KEY": "your_key_here" }
    }
  }
}

Poetry (from source)

{
  "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.

Other MCP clients (Cursor, Continue, Zed, etc.)

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

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

Troubleshooting

Issue	Solution
"Invalid API key"	Verify key at https://app.reclaim.ai/settings/developer
Rate limited (429)	Server handles retries automatically; reduce request frequency
Tools not showing	Restart Claude Desktop after config change
Docker ARM64 warning	Use 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

License

MIT – Falko Sieverding (@UniversalAmateur)

_{Built with FastMCP · Not affiliated with Reclaim.ai}

from github.com/universalamateur/reclaim-mcp-server

Installing universalamateur/reclaim-mcp-server

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/universalamateur/reclaim-mcp-server

FAQ

Is universalamateur/reclaim-mcp-server MCP free?

Yes, universalamateur/reclaim-mcp-server MCP is free — one-click install via Unyly at no cost.

Does universalamateur/reclaim-mcp-server need an API key?

No, universalamateur/reclaim-mcp-server runs without API keys or environment variables.

Is universalamateur/reclaim-mcp-server hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install universalamateur/reclaim-mcp-server in Claude Desktop, Claude Code or Cursor?

Open universalamateur/reclaim-mcp-server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.