The MinuteDock MCP server lets you connect your MinuteDock account to AI assistants like Claude and ChatGPT. Once connected, you can ask your assistant about your tracked time, generate summaries, and perform bulk actions in plain language.
What the MCP server can do
Once connected, your AI assistant can:
Look up Contacts, Projects, Tasks, Users, and your Account profile
Create and update Contacts, Projects, and Tasks, including their rates, budgets, and Short Codes, and archive or restore them. Contacts need the Manage Contacts Permission; Projects and Tasks need Manage Projects & Tasks.
Search your Time Entries and filter by date, Contact, Project, Task, User, billable status, approval, or invoiced status
Generate reports grouped by Contact, User, Project, or time period
Create, edit, and delete Time Entries
List Invoices and read a single Invoice, including its line items. This needs the Manage Invoices & See Billing Reports Permission.
The MCP can't create or send Invoices, and it can't delete Contacts, Projects, or Tasks.
When your assistant changes Contacts, Projects, or Tasks:
If a Contact with the same name already exists, including an archived one, the assistant gets that Contact back instead of creating a duplicate.
Moving a Project to another Contact moves its Time Entries too, and their rates can change to match the new Contact.
Archiving a Contact through the MCP doesn't archive its Projects, unlike archiving it in MinuteDock.
Pinning a Contact or Project pins it for everyone in your Account.
If your Account is connected to Xero, Xero is the source of truth for Contact details, so changes to a synced Contact can be overwritten at the next sync.
Permissions
The MCP acts on your behalf using your MinuteDock login, so it can only see and do what you can when signed in directly. If results look incomplete (for example, missing billable values or other Users' time), check your User Permissions in MinuteDock.
Connect your AI assistant
Claude
Claude
Claude supports MCP servers through Connectors.
In Claude, go to Settings → Connectors and click Add custom connector.
Name it MinuteDock and paste in the server URL:
https://mcp.minutedock.com/mcpSign in to your MinuteDock Account when prompted.
MinuteDock will then appear as a tool in any new Claude conversation. Claude will ask for your permission before performing any action.
ChatGPT
ChatGPT
ChatGPT connects to MCP servers as a custom (developer mode) connector. OpenAI's connector documentation covers the full setup; the steps below are a summary.
⚠️ Important: While we are still waiting to be accepted into the ChatGPT Apps Marketplace, you can connect in the meantime with a Custom MCP Connector. Custom MCP connectors are only available on paid ChatGPT plans.
Enable Developer Mode in ChatGPT
In ChatGPT, go to Settings → Apps & Connectors → Advanced settings, then toggle Developer mode, assuming your workspace allows it. Workspace admins may need to enable it first under admin settings for custom MCP connectors.
Create the connector
Go to Settings → Connectors → Create, then enter:Connector name
Description
Name it MinuteDock and paste in the server URL:
https://mcp.minutedock.com/mcpSign in to your MinuteDock Account when prompted.
Enable the connector in any chat where you want to use it.
Other clients (manual setup)
Other clients (manual setup)
Any AI client that supports MCP can connect using:
Server URL:
https://mcp.minutedock.com/mcpTransport: HTTP
Authentication: OAuth — Sign in with your MinuteDock credentials when prompted.
Check your AI client's documentation for how to add a custom MCP server.
Example prompts
Get a summary of your week
"How much time did I track last week, broken down by client?"
"What were my top three Projects by hours this month?"
Check billable value before invoicing
"How much billable time is ready to invoice for Acme Corp?"
"Show me un-invoiced billable time for all clients this quarter."
Log time conversationally
"Log 45 minutes on 'quarterly review call' for Acme Corp today."
"Add 2 hours of research to the Website Redesign project yesterday."
Set up clients and projects
"Create a Contact called Harbour Design with a $150 hourly rate."
"Add a Project called Website Redesign under Acme Corp with a 40-hour monthly budget."
Review team activity
"How many hours did each team member track last month?"
"Who spent the most time on Acme Corp this quarter?"
ℹ️ Note: Team-wide reporting needs the See & report on others' time Permission. With Can report on other users' time with the same role, results cover only Users who share your Role. If you manage other Users, results cover the people you manage.