English Français العربية

io.github.universalamateur/reclaim-mcp-server

السجل الرسمي الإنتاجية

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package reclaim-mcp-server
Claude Code 
claude mcp add reclaim-mcp-server -- uvx reclaim-mcp-server==0.9.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "reclaim-mcp-server": {
            "command": "uvx",
            "args": [
                "reclaim-mcp-server==0.9.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Reclaim.ai MCP Server (UNOFFICIAL)
  2. What You Can Do
  3. Quick Start
  4. Installation Options
  5. Tool Profiles
  6. Other Configurations
  7. Troubleshooting
  8. Development
  9. Links
  10. License

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

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

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

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

License

MIT – Falko Sieverding (@UniversalAmateur)

Built with FastMCP · Not affiliated with Reclaim.ai

الأسئلة الشائعة

ما هو io.github.universalamateur/reclaim-mcp-server؟

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

كيف أثبّت io.github.universalamateur/reclaim-mcp-server؟

يعمل على جهازك. في Claude Code: claude mcp add reclaim-mcp-server -- uvx reclaim-mcp-server==0.9.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.universalamateur/reclaim-mcp-server إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.universalamateur/reclaim-mcp-server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.universalamateur/reclaim-mcp-server؟

ينشره universalamateur. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.