Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Everhour

Scalekit connector
Open markdown

The Everhour connector lets your AI agent act in each user's Everhour account. Each user connects their own Everhour API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

Tools
60
What they doRead · write · destructive
28 · 25 · 728 read25 write7 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Everhour connection

    In AgentKit > Connections, create an Everhour connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'everhour'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Everhour:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'everhour_assignments_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Everhour credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • everhour_assignments_listList resource-planner assignments (scheduled work and time off) in a date range.Read-only

    List Schedule Assignments

    List resource-planner assignments (scheduled work and time off) in a date range. Returns a list of records with days, endDate, id, project, startDate, time, type, user. Use this to see who is scheduled on what.

    Inputs

    allow_removed_usersboolean
    Include assignments of users removed from the team. Example: false
    clientnumber
    Filter by Client ID. Example: 107
    fromstring
    Get Assignments Starting From. Example: 2026-01-01
    projectstring
    Project ID the record belongs to. Example: ev:1234567789001
    taskstring
    Filter by Task ID. Example: ev:1234567789002
    tostring
    Get Assignments Ending At. Example: 2026-01-31
    typestring
    Filter by Assignment Type. One of: time-off, assignment. Example: time-offone of time-offassignment
  • everhour_client_getGet one client by ID, with its projects, budget and invoice details.Read-only

    Get Client

    Get one client by ID, with its projects, budget and invoice details. Returns id, name, projects, businessDetails, budget. Use everhour_clients_list to find the client ID.

    Inputs

    client_idnumberrequired
    Client ID. Example: 107
  • everhour_clients_listList clients in the Everhour team, optionally filtered by name.Read-only

    List Clients

    List clients in the Everhour team, optionally filtered by name. Returns a list of records with id, name, projects, businessDetails, budget. Use this to find a client ID. Use everhour_client_get for one client's details.

    Inputs

    querystring
    Search Clients by Name. Example: design
  • everhour_clients_report_getGet the clients report: time, costs and billable amounts per client for a date range.Read-only

    Get Clients Report

    Get the clients report: time, costs and billable amounts per client for a date range. Returns a list of records with clientId, clientName, time, billableTime, nonBillableTime, timerTimePc, billableAmount, billableAmountTime, billableAmountExpenses, costs. Use this for client-level totals.

    Inputs

    client_idnumber
    Filter by client ID. Example: 12345
    date_gtestring
    Report start date. Example: 2020-01-01
    date_ltestring
    Report end date. Example: 2021-01-01
    member_idnumber
    Filter by user ID. Example: 7890
    project_idstring
    Filter by project ID. Example: as:123456789012345
  • everhour_expense_categories_listList expense categories with their IDs, names, colors and unit prices.Read-only

    List Expense Categories

    List expense categories with their IDs, names, colors and unit prices. Returns a list of records with color, id, name, unitBased, unitName, unitPrice. Use this to get a category ID for everhour_expense_create.

    Inputs

    This tool takes no inputs.

  • everhour_expenses_listList expenses, optionally in a date range or for a project, user or category.Read-only

    List Expenses

    List expenses, optionally in a date range or for a project, user or category. Returns a list of records with amount, attachments, billable, category, date, details, id, project, quantity, user. Use this to review spending. Amounts are in cents.

    Inputs

    This tool takes no inputs.

  • everhour_invoice_getGet one invoice with its line items, totals, tax, discount and status.Read-only

    Get Invoice

    Get one invoice with its line items, totals, tax, discount and status. Returns id, client, createdAt, createdBy, dateFrom, dateTill, dueDate, discount, expenseMask, includeExpenses. Get the invoice ID from everhour_invoices_list.

    Inputs

    invoice_idnumberrequired
    Invoice ID. Example: 5521
  • everhour_invoices_listList invoices, optionally filtered by client or status.Read-only

    List Invoices

    List invoices, optionally filtered by client or status. Returns a list of records with id, client, createdAt, createdBy, dateFrom, dateTill, dueDate, discount, expenseMask, includeExpenses. Use everhour_invoice_get for one invoice's line items.

    Inputs

    This tool takes no inputs.