Configure Cursor

Add the Hoursmith MCP server to Cursor — edit ~/.cursor/mcp.json (or Settings → MCP), paste the config block, and reload.

Cursor uses the same mcpServers config format as Claude Desktop. Add the Hoursmith block to Cursor's MCP file, drop in your token, and reload.

Before you start

Plan: StudioAgency

You need Node.js 18+ and an hsk_ API token. Have the token ready before you start.

Add the server

Open Cursor's MCP config

Edit the file:

~/.cursor/mcp.json

You can also reach it from Settings → MCP inside Cursor. If the file doesn't exist, create it.

Add the Hoursmith block

Paste this in, replacing hsk_live_... with your own token:

{
  "mcpServers": {
    "hoursmith": {
      "command": "npx",
      "args": ["-y", "@hoursmith/mcp-server"],
      "env": { "HOURSMITH_API_TOKEN": "hsk_live_..." }
    }
  }
}

If you already have other servers under mcpServers, add hoursmith alongside them.

Reload Cursor

Restart Cursor (or reload the MCP servers from Settings → MCP) so it picks up the new config.

After editing the config, give Cursor a moment to start the server — the first launch downloads the package via npx, so it can take a few seconds before the tools appear.

Verify it worked

Ask Cursor's assistant a read-only question to confirm the connection:

What did I track this week in Hoursmith?

That uses list_time_entries. See Example prompts for more, and Available tools for everything you can do.

If it doesn't connect

Check the token, your Node version, and the config path. Start with Troubleshooting or MCP won't connect.

Was this page helpful?