Skip to content

MCP_CLIENTS.md

Latest commit

 

History

History
175 lines (129 loc) · 4.15 KB

MCP_CLIENTS.md

File metadata and controls

175 lines (129 loc) · 4.15 KB
Raw

MCP Client Configuration Guide

This guide provides detailed configuration instructions for all supported MCP clients.

Quick Reference

All clients use the same basic configuration format:

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

Replace /absolute/path/to/TimeTree-MCP with your cloned repository path. If your GUI client cannot find node, use the absolute path from command -v node as command. npm link is optional convenience, not required for this configuration.

Supported Clients

1️⃣ Claude Desktop (macOS)

File: ~/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"
      }
    }
  }
}

Then: Restart Claude Desktop (Cmd+Q and reopen)

2️⃣ Claude Desktop (Windows)

File: %APPDATA%\Claude\claude_desktop_config.json

Configuration: Same as macOS (see above)

Then: Restart Claude Desktop

3️⃣ Claude Code (CLI) 
claude mcp add timetree \
  --env TIMETREE_EMAIL=your@email.com \
  --env TIMETREE_PASSWORD=yourpass \
  -- node /absolute/path/to/TimeTree-MCP/dist/index.js
4️⃣ Codex (OpenAI)

File: ~/.codex/config.toml (or .codex/config.toml for project-specific)

[[mcp.servers]]
name = "timetree"
command = "node"
args = ["/absolute/path/to/TimeTree-MCP/dist/index.js"]

[mcp.servers.env]
TIMETREE_EMAIL = "your-email@example.com"
TIMETREE_PASSWORD = "your-password"

Then: Restart Codex CLI or reload IDE extension

5️⃣ Google Antigravity

File (Windows): C:\Users\<USER_NAME>\.gemini\antigravity\mcp_config.json

File (macOS/Linux): ~/.gemini/antigravity/mcp_config.json

Or via UI: Click ⋮ (top right) → MCP Servers → Manage MCP Servers → View raw config

{
  "mcpServers": {
    "timetree": {
      "command": "node",
      "args": ["/absolute/path/to/TimeTree-MCP/dist/index.js"],
      "env": {
        "TIMETREE_EMAIL": "your-email@example.com",
        "TIMETREE_PASSWORD": "your-password"
      }
    }
  }
}
6️⃣ VS Code-based Editors (Cline, Cursor, Windsurf, etc.)

Configuration varies by editor. Most use similar MCP config format.

Example for Cline (VS Code Extension):

File: cline_mcp_settings.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"
      }
    }
  }
}

Then: Reload your editor window

7️⃣ Other MCP Clients

Most MCP clients support this standard format:

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

Security Note

⚠️ Never commit your credentials to version control!

  • Store credentials only in MCP client config files
  • These config files should be in your gitignore
  • Consider using environment variables for added security
  • Prefer node /absolute/path/to/TimeTree-MCP/dist/index.js to avoid PATH/npm-link issues. If you choose the optional timetree-mcp command and it is not found, run npm link again from your cloned TimeTree-MCP directory or switch back to the absolute node/dist path.

Need Help?