FreeAgent MCP

Name: FreeAgent MCP
Author: markpitt

markpitt

Get started Repository

Lets Claude work with a FreeAgent account to track time, manage timers and handle timeslips.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add freeagent --env FREEAGENT_ACCESS_TOKEN='<FREEAGENT_ACCESS_TOKEN>' --env FREEAGENT_CLIENT_ID='<FREEAGENT_CLIENT_ID>' --env FREEAGENT_CLIENT_SECRET='<FREEAGENT_CLIENT_SECRET>' --env FREEAGENT_REFRESH_TOKEN='<FREEAGENT_REFRESH_TOKEN>' -- node path/to/freeagent-mcp/build/index.js

~/.codex/config.toml

[mcp_servers.freeagent]
command = "node"
args = ["path/to/freeagent-mcp/build/index.js"]
env = { FREEAGENT_ACCESS_TOKEN = "<FREEAGENT_ACCESS_TOKEN>", FREEAGENT_CLIENT_ID = "<FREEAGENT_CLIENT_ID>", FREEAGENT_CLIENT_SECRET = "<FREEAGENT_CLIENT_SECRET>", FREEAGENT_REFRESH_TOKEN = "<FREEAGENT_REFRESH_TOKEN>" }

# codex mcp add freeagent --env FREEAGENT_ACCESS_TOKEN='<FREEAGENT_ACCESS_TOKEN>' --env FREEAGENT_CLIENT_ID='<FREEAGENT_CLIENT_ID>' --env FREEAGENT_CLIENT_SECRET='<FREEAGENT_CLIENT_SECRET>' --env FREEAGENT_REFRESH_TOKEN='<FREEAGENT_REFRESH_TOKEN>' -- node path/to/freeagent-mcp/build/index.js

~/.cursor/mcp.json

{
  "mcpServers": {
    "freeagent": {
      "command": "node",
      "args": [
        "path/to/freeagent-mcp/build/index.js"
      ],
      "env": {
        "FREEAGENT_ACCESS_TOKEN": "<FREEAGENT_ACCESS_TOKEN>",
        "FREEAGENT_CLIENT_ID": "<FREEAGENT_CLIENT_ID>",
        "FREEAGENT_CLIENT_SECRET": "<FREEAGENT_CLIENT_SECRET>",
        "FREEAGENT_REFRESH_TOKEN": "<FREEAGENT_REFRESH_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "freeagent": {
      "type": "stdio",
      "command": "node",
      "args": [
        "path/to/freeagent-mcp/build/index.js"
      ],
      "env": {
        "FREEAGENT_ACCESS_TOKEN": "<FREEAGENT_ACCESS_TOKEN>",
        "FREEAGENT_CLIENT_ID": "<FREEAGENT_CLIENT_ID>",
        "FREEAGENT_CLIENT_SECRET": "<FREEAGENT_CLIENT_SECRET>",
        "FREEAGENT_REFRESH_TOKEN": "<FREEAGENT_REFRESH_TOKEN>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "freeagent": {
      "command": "node",
      "args": [
        "path/to/freeagent-mcp/build/index.js"
      ],
      "env": {
        "FREEAGENT_ACCESS_TOKEN": "<FREEAGENT_ACCESS_TOKEN>",
        "FREEAGENT_CLIENT_ID": "<FREEAGENT_CLIENT_ID>",
        "FREEAGENT_CLIENT_SECRET": "<FREEAGENT_CLIENT_SECRET>",
        "FREEAGENT_REFRESH_TOKEN": "<FREEAGENT_REFRESH_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "freeagent": {
      "command": "node",
      "args": [
        "path/to/freeagent-mcp/build/index.js"
      ],
      "env": {
        "FREEAGENT_ACCESS_TOKEN": "<FREEAGENT_ACCESS_TOKEN>",
        "FREEAGENT_CLIENT_ID": "<FREEAGENT_CLIENT_ID>",
        "FREEAGENT_CLIENT_SECRET": "<FREEAGENT_CLIENT_SECRET>",
        "FREEAGENT_REFRESH_TOKEN": "<FREEAGENT_REFRESH_TOKEN>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "freeagent": {
      "command": "node",
      "args": [
        "path/to/freeagent-mcp/build/index.js"
      ],
      "env": {
        "FREEAGENT_ACCESS_TOKEN": "<FREEAGENT_ACCESS_TOKEN>",
        "FREEAGENT_CLIENT_ID": "<FREEAGENT_CLIENT_ID>",
        "FREEAGENT_CLIENT_SECRET": "<FREEAGENT_CLIENT_SECRET>",
        "FREEAGENT_REFRESH_TOKEN": "<FREEAGENT_REFRESH_TOKEN>"
      }
    }
  }
}

Environment variables

FREEAGENT_ACCESS_TOKEN
FREEAGENT_CLIENT_ID
FREEAGENT_CLIENT_SECRET
FREEAGENT_REFRESH_TOKEN

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related