Time entry CLI, web UI, and TUI for Costpoint.

Requires Node.js 18 or later.

git clone <repo-url>
cd tecli
npm install
npm link
te login

npm link makes the te command available globally. te login prompts for your username and password and stores them in your OS keychain (macOS Keychain, GNOME Keyring on Linux, or an encrypted file as fallback). Nothing is saved in plaintext.

te show                        # show timesheet
te set <line> <day> <hours>    # set hours (e.g. te set 1 4 8)
te setm 1 1 8, 1 2 8, 1 3 8   # set multiple cells
te add ZLEAVE.HOL              # add a project line
te add ZLEAVE.FTB RHB          # add a multi-charge project line
te sign                        # sign timesheet
te leave                       # show leave balances
te server                      # start the web UI (port 3000)
te tui                         # start the interactive terminal UI
te logout                      # remove stored credentials

The MCP server exposes timesheet tools to AI assistants like Claude. It uses stdio transport and the same credential system as the CLI.

claude mcp add tecli -- node /path/to/tecli/mcp-server.js

Replace /path/to/tecli with the actual path to this repo. For example:

claude mcp add tecli -- node ~/dev/tecli/mcp-server.js

To verify it was added:

claude mcp list

Add to your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tecli": {
      "command": "node",
      "args": ["/path/to/tecli/mcp-server.js"]
    }
  }
}

The server uses stdio transport. Point your client at:

node /path/to/tecli/mcp-server.js

The MCP server uses the same credential resolution as the CLI:

1. Stored credentials from te login (~/.tecli.json + OS keychain)
2. Environment variables (COSTPOINT_URL, COSTPOINT_USERNAME, COSTPOINT_PASSWORD)

If you haven't run te login yet, do that first — the MCP server picks up stored credentials automatically.

This repository is not affiliated, associated, authorized, endorsed by, or in any way officially connected with Deltek, Inc.