reclaim-mcp-server

Name: reclaim-mcp-server
Author: universalamateur

Local

github.com/universalamateurProductivity4Updated 35w ago

Repository

About reclaim-mcp-server

reclaim-mcp-server is an unofficial MCP server for managing Reclaim.ai calendars, tasks, habits, focus time, and productivity analytics from AI assistants. It offers 40 tools, with profiles to expose a smaller subset.

Key features

01Manage tasks and calendars
02Track habits and focus time
03View productivity analytics
04Choose a tool profile

Use cases

01Create and schedule a task
02Check upcoming calendar events
03Mark a habit complete
04Review weekly productivity stats

MCP support

Exposes Reclaim.ai operations to MCP-compatible clients through 20, 32, or 40 tools, depending on the selected profile. It uses a Reclaim.ai API key and is not affiliated with Reclaim.ai.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

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

Run commanduvx reclaim-mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

pypireclaim-mcp-server0.9.1stdio

Tools

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

Reclaim.ai MCP Server (UNOFFICIAL)

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}

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.