r

reclaim-mcp-server

@universalamateur/reclaim-mcp-server
Hosted
0 Stars 9 次浏览 universalamateur 更新于 2026-08-23

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

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

可用工具 (5 个)

该服务在 MCP 协议中暴露的工具,AI 可按需调用

tavily_search 14 个参数 需填 1 项

Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

必填参数:query

tavily_extract 6 个参数 需填 1 项

Extract content from URLs. Returns raw page content in markdown or text format.

必填参数:urls

tavily_crawl 11 个参数 需填 1 项

Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

必填参数:url

tavily_map 8 个参数 需填 1 项

Map a website's structure. Returns a list of URLs found starting from the base URL.

必填参数:url

tavily_research 2 个参数 需填 1 项

Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

必填参数:input

服务介绍

Reclaim.ai MCP Server (UNOFFICIAL)

<!- - mcp-name: io.github.universalamateur/reclaim-mcp-server - ->

PyPI Downloads Python

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

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

相关 MCP 服务