# Start Clocking — McTime

> Start a new clocking time entry. See the documentation

- Key: `mctime-start-clocking`
- Type: Action (Write)
- Version: 0.0.2
- App: McTime (`mctime`) — https://pipedream.com/apps/mctime.md
- This page (HTML): https://pipedream.com/apps/mctime/actions/start-clocking
- Hints: destructive · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/mctime/actions/start-clocking/start-clocking.mjs

## Description

Start a new clocking time entry. [See the documentation](https://mctime.readme.io/reference/manipulating-clocking-times)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `userId` | `string` | No | The ID of the user. If provided clock will be assigned for this user. If not provided clock will be assigned to the user who is authenticated and who is making the API call. Options are loaded from the connected account. |
| `dateTime` | `string` | Yes | The dateTime when the clock has started. Provide in ISO-8601 format containing a timezone, eg. 2022-04-25T08:00:00+03:00. |
| `timeType` | `string` | Yes | The type of the clocking time entry |
| `comment` | `string` | No | A comment for the clocking time entry |
| `organizationId` | `string` | Yes | The ID of the organization for the clocking time entry Options are loaded from the connected account. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "mctime",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "mctime-start-clocking",
  arguments: {
    userId: "User ID",
    dateTime: "Start Datetime",
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "mctime-start-clocking",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    mctime: { authProvisionId: "apn_xxxxxxx" },
    userId: "User ID",
    dateTime: "Start Datetime",
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "mctime-start-clocking",
    "configured_props": {
      "mctime": { "authProvisionId": "apn_xxxxxxx" },
      "userId": "User ID",
      "dateTime": "Start Datetime"
    }
  }'
```

---

- App: https://pipedream.com/apps/mctime.md · All apps: https://pipedream.com/apps