{"id":33450,"date":"2026-08-07T11:46:31","date_gmt":"2026-08-07T11:46:31","guid":{"rendered":"https:\/\/clockify.me\/help\/?p=33450"},"modified":"2026-08-07T11:46:34","modified_gmt":"2026-08-07T11:46:34","slug":"use-clockify-mcp-server-to-connect-to-ai-agent","status":"publish","type":"post","link":"https:\/\/clockify.me\/help\/fr\/integrations-and-add-ons\/use-clockify-mcp-server-to-connect-to-ai-agent","title":{"rendered":"Use Clockify MCP server to connect to AI agent"},"content":{"rendered":"<div class=\"wp-block-custom-coming-soon coming-soon color-clockify\"><span class=\"box-label\">BIENT\u00d4T DISPONIBLE<\/span><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Securely connect your favorite AI agent directly to your Clockify account to help you track time, pull reports, and audit timesheets.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Security and permissions<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The AI agent inherits your exact Clockify user permissions<\/li>\n\n\n\n<li>The AI agent can only read data or log time for projects you already have access to<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">G\u00e9n\u00e9rer une cl\u00e9 API<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">You\u2019ll be connecting your AI agent to Clockify using your API key.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">To generate your personal API key:&nbsp;<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Connectez-vous \u00e0 votre compte Clockify<\/li>\n\n\n\n<li>Click on your photo on the top-right corner<\/li>\n\n\n\n<li>S\u00e9lectionner <strong>Pr\u00e9f\u00e9rences<\/strong><\/li>\n\n\n\n<li>Cliquez sur le bouton <strong>Avanc\u00e9<\/strong> .<\/li>\n\n\n\n<li>Cliquez sur l'onglet <strong>G\u00e9rer les cl\u00e9s API<\/strong><\/li>\n\n\n\n<li>S\u00e9lectionner <strong>Generate New<\/strong><\/li>\n<\/ol>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"439\" src=\"https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api-1024x439.webp\" alt=\"\" class=\"wp-image-33472\" srcset=\"https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api-1024x439.webp 1024w, https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api-300x128.webp 300w, https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api-768x329.webp 768w, https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api-1536x658.webp 1536w, https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api-18x8.webp 18w, https:\/\/clockify.me\/help\/wp-content\/uploads\/2026\/08\/generate-api.webp 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Connect Clockify MCP to Gemini CLI<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">When you have obtained your API key, you can connect it to your Gemini CLI.<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Locate your settings.json file, which is normally located in your user root directory inside the hidden .gemini folder (cd ~\/.gemini\/).<br><br><strong>Remarque :<\/strong> On macOS, you can press CMD+SHIFT+G and type this path to open the directory directly.<br><\/li>\n\n\n\n<li>Open the settings.json file and add the following code:<\/li>\n<\/ol>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n\"mcpServers\": {\n  \"posts-api-mcp\": {\n    \"httpUrl\": \"https:\/\/mcp-server.stage.ops.clockify.me\/mcp-server\/mcp\",\n    \"headers\": {\n      \"x-api-key\": \"API_KEY\"\n    }\n  }\n}\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">3. Replace API_KEY with the API key generated from your workspace.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Restart Gemini to start using the Clockify MCP server.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Or you can use the following command:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>gemini mcp add --transport http --header \"x-api-key: API_KEY\" posts-api-mcp https:\/\/mcp-server.stage.ops.clockify.me\/mcp-server\/mcp<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Replace API_KEY with the API key generated from your workspace.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Connect Clockify MCP to Claude CLI<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">If you are using Claude CLI, you can also connect it to the Clockify MCP server. To do this, paste the code below into your .mcp.json file:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"mcpServers\": {\n    \"clockify-mcp\": {\n      \"type\": \"http\",\n      \"url\": \"https:\/\/mcp-server.stage.ops.clockify.me\/mcp-server\/mcp\",\n      \"headers\": {\n        \"x-api-key\": \"API_KEY\"\n      }\n    }\n  }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Or, you can use the following command:<br><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>claude mcp add clockify-mcp https:\/\/mcp-server.stage.ops.clockify.me\/mcp-server\/mcp --transport http --header \"x-api-key: API_KEY\"<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Replace API_KEY with the API key generated from your workspace.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Connect Clockify MCP to Codex CLI<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The Clockify MCP server can also connect to the Codex CLI. To do this, simply paste the code below into your config.toml file:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&#91;mcp_servers.clockify-mcp]\ntransport = \"http\"\nurl = \"https:\/\/mcp-server.stage.ops.clockify.me\/mcp-server\/mcp\"\nhttp_headers = { \"x-api-key\" = \"API_KEY\" }<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Replace API_KEY with the API key generated from your workspace.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Ce que vous pouvez faire<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The available tools and actions depend on your existing Clockify Role-Based Access Control (RBAC) permissions. These are all the available tools that the Clockify MCP server lets you use:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Tools are the core actions the AI agent can perform for you in Clockify:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong>Tool<\/strong><\/td><td><strong>Description<\/strong><\/td><\/tr><tr><td><strong>D\u00e9marrer le minuteur<\/strong><\/td><td>Start a timer naturally. You can also backdate timers, log &#8220;Breaks&#8221; (if enabled in your workspace), or ask the AI agent to attach available Custom Fields in your workspace such as mileage, expenses, location, or department.<\/td><\/tr><tr><td><strong>stop timer<\/strong><\/td><td>Stop your current timer. You can also ask the AI agent to add missing details as you stop it.<\/td><\/tr><tr><td><strong>log past time<\/strong><\/td><td>Log historical time. You can give the AI agent a simple duration, ask it to split time across a full day, or give it a sequence of tasks to stack back-to-back starting from your morning clock-in.<\/td><\/tr><tr><td><strong>update time entry<\/strong><\/td><td>Fix mistakes in your past logs. Just tell the AI agent what needs changing and it will find the entry and update the project, task, tag, or description.<\/td><\/tr><tr><td><strong>bulk update time entries<\/strong><\/td><td>Make massive changes instantly without slowing down. You can say, <em>&#8220;Mark all my entries from yesterday as billable,&#8221;<\/em> and the AI agent will update them all at once.<\/td><\/tr><tr><td><strong>list time entries<\/strong><\/td><td>The AI agent uses this to understand conversational references like <em>&#8220;the entry from yesterday morning&#8221;<\/em> so you don&#8217;t have to look up exact dates or IDs.<\/td><\/tr><tr><td><strong>create client \/ project \/ task \/ tag<\/strong><\/td><td>Create new workspace items on the fly just by asking the AI agent to set them up.<\/td><\/tr><tr><td><strong>get current timer<\/strong><\/td><td>Ask the AI agent what you are currently working on to get a quick status update.<\/td><\/tr><tr><td><strong>list custom fields<\/strong><\/td><td>The AI agent uses this to check which custom fields (like expenses or drop-downs) are available in your workspace so it applies them accurately.<\/td><\/tr><tr><td><strong>list clients \/ projects \/ tasks \/ tags<\/strong><\/td><td>The AI agent searches these lists to instantly recognize the names of the things you are working on.<\/td><\/tr><tr><td><strong>get summary report<\/strong><\/td><td>Ask conversational questions about your time (<em>&#8220;Show me billable hours for the last 6 months&#8221;<\/em> ou <em>&#8220;How much time went to the Apollo project in Q3?&#8221;<\/em>), and the AI agent will calculate the dates and pull the exact totals.<\/td><\/tr><tr><td><strong>get detailed report<\/strong><\/td><td>Fetch a granular list of individual time entries to audit specific historical tasks.<\/td><\/tr><tr><td><strong>generate attendance report<\/strong><\/td><td>Check your exact daily, weekly, or monthly capacity, including precise overtime and undertime calculations (<strong>Requires a Pro plan<\/strong>).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Available prompts (Pre-built workflows)<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Prompts are smart, multi-step routines the AI agent can run to analyze your work by using your historical time entries to generate reports, audit your timesheets, and assess productivity.&nbsp;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For example, you can run the <strong>productivity pattern audit<\/strong> prompt to analyze your chronological time entries from the last month to see when you are most focused.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><td><strong>Prompt<\/strong><\/td><td><strong>Description<\/strong><\/td><\/tr><tr><td><strong>generate daily standup<\/strong><\/td><td>Formats a professional, copy-pasteable summary of the previous workday&#8217;s tracked hours for your team chats.<\/td><\/tr><tr><td><strong>audit timesheet<\/strong><\/td><td>Scans recent logs to find common anomalies like missing metadata (projects, clients, tags, and description), unlogged days, or accidentally left-on timers.<\/td><\/tr><tr><td><strong>client billing summary<\/strong><\/td><td>Generates a polished breakdown of hours distributed across a client&#8217;s projects.<\/td><\/tr><tr><td><strong>project burn rate analyzer<\/strong><\/td><td>Compares actual time tracked against a project&#8217;s original estimate to see if you are on track or over budget.<\/td><\/tr><tr><td><strong>team utilization audit<\/strong><\/td><td>Reviews a team&#8217;s utilization rates, calculating the billable efficiency for each member and comparing it to the expected target goal.<\/td><\/tr><tr><td><strong>productivity pattern audit<\/strong><\/td><td>Analyzes chronological time entries to measure context-switching, deep work intervals, and overall daily rhythm.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Available resources<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The AI agent silently reads following resources in the background so it never has to ask you same setup questions:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>user profile<\/strong>: Gives the AI agent your identity, workspace settings, local timezone, default workday start time, daily capacity, and which day your work week starts on.\u00a0<\/li>\n\n\n\n<li><strong>recent time entries<\/strong>: Supplies a historical log of your recent time entries so the AI agent understands your current context and habits.<\/li>\n<\/ul>\n\n\n\n<h1 class=\"wp-block-heading\">Glossary<\/h1>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Actions:<\/strong> The specific operations or commands executed by the AI agent to manage your Clockify data, such as logging time, updating entries, or fetching reports.<br><\/li>\n\n\n\n<li><strong>AI agent:<\/strong> An artificial intelligence system (accessed via Gemini, Claude, or Codex CLI) that securely connects to your workspace to track time, analyze data, and execute tasks conversationally.<\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>API Key:<\/strong> A unique security token generated within your Clockify account preferences, used to authenticate and authorize the AI agent&#8217;s access to your workspace.<br><\/li>\n\n\n\n<li><strong>CLI (Command Line Interface):<\/strong> The text-based terminal environment (e.g., Gemini CLI, Claude CLI, Codex CLI) where you configure the settings to connect your AI agent to the MCP server.<br><\/li>\n\n\n\n<li><strong>Custom Fields:<\/strong> Additional categorizations within your Clockify workspace (such as mileage, expenses, location, or department) that the AI agent can automatically attach to your time entries.<br><\/li>\n\n\n\n<li><strong>MCP (Model Context Protocol) Server:<\/strong> The secure integration bridge that enables your AI agent to read context and safely execute actions within your Clockify account.<br><\/li>\n\n\n\n<li><strong>Prompts (Pre-built Workflows):<\/strong> Smart, multi-step analytical routines the AI agent can run on your behalf, such as auditing timesheets, generating standup reports, or analyzing productivity patterns.<br><\/li>\n\n\n\n<li><strong>RBAC (Role-Based Access Control):<\/strong> The security framework in Clockify that determines exactly which projects and permissions your AI agent inherits when interacting with your workspace.<br><\/li>\n\n\n\n<li><strong>Resources:<\/strong> Background data such as your user profile, local timezone, daily capacity, and recent time entries that the AI agent silently reads to contextualize your requests without requiring manual setup.<br><\/li>\n\n\n\n<li><strong>Tools:<\/strong> The core, built-in functions the AI agent uses to interact with Clockify, ranging from starting and stopping timers to generating detailed billing and attendance reports.<\/li>\n<\/ul>","protected":false},"excerpt":{"rendered":"Securely connect your favorite AI agent directly to your Clockify account to hel&#8230;","protected":false},"author":65,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_helpful_status":1,"_searchwp_excluded":"","footnotes":""},"categories":[69],"tags":[],"class_list":["post-33450","post","type-post","status-publish","format-standard","hentry","category-integrations"],"acf":[],"featured_image_src":null,"author_info":{"display_name":"karla.barloso@cake.com","author_link":"https:\/\/clockify.me\/help\/fr\/author\/karla-barlosocake-com"},"_links":{"self":[{"href":"https:\/\/clockify.me\/help\/fr\/wp-json\/wp\/v2\/posts\/33450","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/clockify.me\/help\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/clockify.me\/help\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/fr\/wp-json\/wp\/v2\/users\/65"}],"replies":[{"embeddable":true,"href":"https:\/\/clockify.me\/help\/fr\/wp-json\/wp\/v2\/comments?post=33450"}],"version-history":[{"count":2,"href":"https:\/\/clockify.me\/help\/fr\/wp-json\/wp\/v2\/posts\/33450\/revisions"}],"predecessor-version":[{"id":33474,"href":"https:\/\/clockify.me\/help\/fr\/wp-json\/wp\/v2\/posts\/33450\/revisions\/33474"}],"wp:attachment":[{"href":"https:\/\/clockify.me\/help\/fr\/wp-json\/wp\/v2\/media?parent=33450"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/clockify.me\/help\/fr\/wp-json\/wp\/v2\/categories?post=33450"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/clockify.me\/help\/fr\/wp-json\/wp\/v2\/tags?post=33450"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}