Developer tools

Talentflake MCP

Connect an AI assistant to your Talentflake workspace to look up your projects and time, or manage your attendance. Each person connects their own account through OAuth. Your existing workspace access controls what the assistant can see and do.

Server address

https://www.talentflake.com/mcp

The server uses OAuth. Do not put access tokens or passwords in an MCP client configuration file.

Tool catalog

What your assistant can do

23 tools across 5 categories

Write tools are available only when enabled by the Talentflake deployment. New time reports remain pending approval.

Workspace

Search user manuals

Read

Search Talentflake user manuals for guidance and procedures. Use for questions about how to use Talentflake; use other tools for live account data.

search_user_manuals

Get my Talentflake context

Read

Get your identity, current organization, company memberships, roles, and whether MCP writes are enabled.

get_my_context

List my companies

Read

List the companies you can access in your current organization.

list_my_companies

Projects and time

List accessible projects

Read

List projects you can access, including activity IDs used for time reporting.

list_projects

List my time reports

Read

List your own time reports for an inclusive date range.

list_my_time_reports

Get my time-report summary

Read

Summarize your own reported hours and statuses by week for the current dashboard period.

get_my_time_report_summary

List my pending time-report approvals

Read

List submitted time reports within your existing approval scope, optionally filtered by date range or project.

Available only when MCP writes are enabled and you have time-report approval access.

list_my_pending_time_report_approvals

Create a time report

Write

Record your time against an accessible project and activity. New entries are pending approval.

create_time_report

Update my time report

Write

Edit your own pending time report, or correct and resubmit your own rejected time report. Submitted and approved reports cannot be edited.

update_my_time_report

Delete my pending time report

Write

Delete your own time report only while it is pending. This permanently removes the entry.

delete_my_pending_time_report

Attendance

Get my active check-in

Read

Get your current attendance check-in, if one is active.

get_my_active_check_in

Check in

Write

Start your attendance check-in using the server timestamp. Check for an active check-in first. This does not collect GPS or device location.

check_in

Check out

Write

End your own active attendance check-in using its ID and the server timestamp. Check your active check-in first. When permitted, checkout also synchronizes attendance-based daily timesheet drafts.

check_out

Leave

List my leave requests

Read

List your own leave requests, optionally filtered by status or by an inclusive date range (provide both start and end dates).

list_my_leave_requests

List my assigned leave types

Read

List leave types assigned to you in your current company policy.

list_my_leave_types

Get my leave balance

Read

Show your own leave balance components for a calendar year, including closing and reserved amounts.

get_my_leave_balance

List my pending leave approvals

Read

List submitted leave requests in your company that you are authorized to approve, optionally filtered by date range.

Available only when MCP writes are enabled and you have leave approval access.

list_my_pending_leave_approvals

Expenses

List my expense claims

Read

List your own expense claims and line summaries with approval and reimbursement status. Receipt links and files are not returned.

list_my_expense_claims

List my expense categories

Read

List active expense categories, currencies, payment sources, and receipt requirements for a company where you can create expenses.

list_my_expense_categories

Create an expense claim draft

Write

Create a draft expense claim with one or more line items. The draft is not submitted and this tool does not upload receipt files; use the same idempotency key only when retrying the same draft.

Requires MCP writes to be enabled and expense creation permission for the company.

create_expense_claim_draft

List my reimbursements

Read

List your own reimbursement payment status and payment details when available.

list_my_reimbursements

List my pending expense approvals

Read

List pending expense claims assigned to your approval authority for one company. The server filters the queue to approval steps you may review.

Available only when MCP writes are enabled and you have approval access.

list_my_expense_approval_queue

Decide an expense claim

Write

Approve, reject, or return one pending expense claim using its current workflow version. The database enforces approver assignment, policy checks, self-approval rules, and idempotency.

Requires MCP writes to be enabled and approval access for the claim.

decide_expense_claim

Connect from Codex

codex mcp add talentflake --url https://YOUR_TALENTFLAKE_DOMAIN/mcp
codex mcp login talentflake

Connect from VS Code

{
  "servers": {
    "talentflake": {
      "type": "http",
      "url": "https://YOUR_TALENTFLAKE_DOMAIN/mcp"
    }
  }
}

Start the server in VS Code and complete the OAuth sign-in.

Connect from ChatGPT

Add Talentflake as a custom MCP server from ChatGPT on the web.

OpenAI setup guide
  1. In ChatGPT, open Plugins, select the plus button, then choose Add custom MCP server.
  2. Name the server Talentflake and enter its public HTTPS address:
  3. Configure authentication, complete the Talentflake OAuth sign-in, review the connection warning, and create the plugin.
  4. Install it, start a new chat, type @, and select Talentflake to use its tools.

Custom MCP access depends on your ChatGPT plan and workspace permissions. Full MCP write support is available on supported Business, Enterprise, and Edu workspaces; Pro connections are limited to read and fetch actions. See the OpenAI guide for current availability.

Review or revoke connected assistants from your signed-in account's Integrations page. For deployment and security details, see the MCP setup guide in the Talentflake repository.