Skip to main content
Glama
universalamateur

reclaim-mcp-server

by universalamateur
OverviewInspectSchemaRelated ServersScoreDiscussions
Python

Reclaim.ai MCP Server (UNOFFICIAL)

PyPI Downloads Python CI 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

Docker

docker pull universalamateur/reclaim-mcp-server

Source

git clone https://gitlab.com/universalamateur1/reclaim-mcp-server.git && cd reclaim-mcp-server && poetry install

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

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

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

Links

License

MIT – Falko Sieverding (@UniversalAmateur)

Built with FastMCP · Not affiliated with Reclaim.ai

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/universalamateur/reclaim-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server