时间树MCP

Requirements

• Node.js >= 18.0.0
• Git (for installation)
• A TimeTree account
• An MCP-compatible client (Claude Desktop, Claude Code, Codex, Antigravity, Cline, etc.)

Installation

🚀 Quick Installation for Your Agent

Copy this prompt into Codex, Claude Code, or another coding agent:

Clone https://github.com/ehs208/TimeTree-MCP, enter the cloned directory, run npm ci && npm run build, then configure my MCP client with a server named timetree that runs node /absolute/path/to/TimeTree-MCP/dist/index.js (use the real cloned path). Store TIMETREE_EMAIL and TIMETREE_PASSWORD only in the MCP client environment configuration, and never hardcode or print secrets.

If this saved you time, please star the repo: https://github.com/ehs208/TimeTree-MCP

Quick Install (Recommended)

One-line installation - Automatically clones, builds, attempts optional npm link, and prints client configuration examples:

curl -fsSL https://raw.githubusercontent.com/ehs208/TimeTree-MCP/main/TimeTree-MCP-install.sh | bash

This project is installed from a GitHub clone, not the npm registry. The script builds the local clone, optionally runs npm link, then prints configuration instructions with absolute node/dist/index.js paths for all supported MCP clients. Just copy the config for your client and add your TimeTree credentials.

Manual Install

<details> <summary>Click to expand manual installation steps</summary>

1. Clone and build:

git clone https://github.com/ehs208/TimeTree-MCP.git
cd TimeTree-MCP
npm ci
npm run build

1. Configure your MCP client:

See the Configuration section below to set up your MCP client.

</details>

Build the project

npm run build

Watch mode (auto-rebuild on changes)

npm run dev ```

Usage

📖 See COMMANDS.md for detailed usage examples and workflows

Configuration

Quick Example (Claude Desktop - macOS):

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "timetree": {
      "command": "node",
      "args": ["/absolute/path/to/TimeTree-MCP/dist/index.js"],
      "env": {
        "TIMETREE_EMAIL": "your-email@example.com",
        "TIMETREE_PASSWORD": "your-password"
      }
    }
  }
}

Replace the path with your cloned repository path. If a GUI client cannot find node, use the absolute path from command -v node as command. Then restart Claude Desktop (Cmd+Q and reopen).

📖 For all MCP clients (Claude Desktop Windows, Claude Code CLI, Codex, Antigravity, VS Code editors, etc.): → See docs/MCP_CLIENTS.md for detailed configuration instructions

Troubleshooting

"Missing required environment variables" error

Make sure TIMETREE_EMAIL and TIMETREE_PASSWORD are set in your MCP configuration.

Authentication fails

• Verify your email and password are correct
• Check if you can log in to TimeTree web app
• TimeTree might have changed their authentication API

No calendars or events returned

• Verify you have calendars/events in your TimeTree account
• Check the logs for detailed error messages
• The API might have changed