@timetick/mcp

Run Timetick from your AI client. Say "I want to test my CSMS" and the agent sets up simulators, runs the test and explains the result. It works with OCPP 1.6 and 2.0.1, and can test a CSMS or a real charger.

Install

Sign up at app.timetick.io and create your first project. Open the user menu, choose API keys and create a key. Then add the server with that key.

Claude Code:

claude mcp add timetick -e TIMETICK_API_TOKEN=your_api_key -- npx -y @timetick/mcp@latest

Codex:

codex mcp add timetick --env TIMETICK_API_TOKEN=your_api_key -- npx -y @timetick/mcp@latest

Gemini CLI, Claude Desktop, Cursor and other MCP clients:

{
  "mcpServers": {
    "timetick": {
      "command": "npx",
      "args": ["-y", "@timetick/mcp@latest"],
      "env": { "TIMETICK_API_TOKEN": "your_api_key" }
    }
  }
}

Keep @latest so you stay on the current version.

To switch accounts, change TIMETICK_API_TOKEN and restart the client. To use two accounts at once, add the server twice, each with its own TIMETICK_API_TOKEN.

Test your CSMS

Simulators connect to your CSMS from Timetick's cloud, so it needs a public ws:// or wss:// address. Your CSMS sees the simulator's name as the charge point identity.

Steps on the charger side, such as plugging in, run automatically. Steps named Remote: wait for your CSMS to send the command. If you set expected results, the step passes or fails on its own. Otherwise the agent asks you what happened.

Test a real charger

Your charger connects to Timetick's CSMS. Someone at the charger does the physical steps, and Remote: steps run automatically.

What you can do

• Create and manage simulators, hardware, models and OCPP configurations
• Write tests or start from a template
• Run tests, test plans and Stress Tests
• Read results and OCPP logs
• Manage projects, tags and API keys

Some things still need the portal: signing up, billing, resetting a password, and security profiles (Basic Auth or certificates towards a CSMS).

Projects and trial

Your first project gets the free trial, which starts when you create it. Any further project needs payment details, which you add in the portal.

A project with no active plan is read-only. If you started onboarding in the portal and didn't finish, ask the agent to start the trial.

If you have several projects, tell the agent which one to use.

Read-only mode

Set TIMETICK_MCP_READONLY=1 and the agent can read your data but not change it.

Help

For questions, write to [email protected].