Getting Started with CTMS in Claude
Connect CTMS to Claude and ask about your ocean containers in your own words. CTMS checks the shipping lines for you and gives Claude the facts: status, ETA at the port of discharge, milestones and the last free day before demurrage and detention. You don't need a carrier account, a spreadsheet or any other app.
1. What you can ask
- "Track [container number] with MSC and [container number] with Maersk."
- "Where is [container number]?"
- "What arrives in Rotterdam this week?"
- "Has the ETA of [container number] slipped?"
- "Which containers run out of free time before Friday?"
- "Our MSC contract gives 14 free days in Hamburg, calendar days. Save that."
- "How many containers do I have left on my plan?"
- "Stop tracking [container number]."
Claude answers from your CTMS account only. It can combine the answers with the rest of your chat, for example to draft an email to a customer about a delay.
2. Connect CTMS in Claude
- In Claude, open Plugins in the sidebar. (In some Claude versions this is still called Customize → Connectors.)
- Search for CTMS Container Tracking (or open its directory page), add it to Claude and choose Connect. If you don't find it there, click Add → Add custom connector, enter the name
CTMSand the MCP server URLhttps://mcp.get-ctms.com/api/mcp, click Continue, leave the sign-in settings as they are and click Add, then Connect. - A CTMS sign-in page opens (see Sign in). After signing in, you're back in Claude and CTMS is connected.
- In a chat, CTMS is available like any other connector. You can switch it off for a chat in the tools menu.
On Claude Team and Enterprise plans, an owner may need to add CTMS for the organisation first.
3. Sign in
The sign-in page is on mcp.get-ctms.com. It shows which app is asking (Claude) and where you return to.
- Email code: enter your work email, and CTMS sends you a 6-digit code. Enter it on the same page within 10 minutes. No password.
- Continue with Google: CTMS receives only your verified email address from Google.
The first sign-in creates a free CTMS account for that email address. It's separate from CTMS in Google Sheets, Gmail, HubSpot, Salesforce, monday.com or Shopify: containers and paid plans there don't show up here, even with the same email address.
Claude stays signed in. You sign in again only after about 30 days without using CTMS, or after you disconnect.
4. Track containers
- Name the carrier for every container, the shipping line on your booking or bill of lading. Containers are leased and shared between lines, so CTMS never guesses the carrier from the number. If you leave it out, Claude asks.
- CTMS tracks MSC, Maersk, Hapag-Lloyd, CMA CGM, ONE, Evergreen and Yang Ming automatically. Containers with other carriers (for example COSCO, HMM or ZIM) can't be tracked here.
- Up to 20 containers per request. Claude should check with you before it starts or stops tracking.
- The first carrier data usually arrives within a few minutes. After that, CTMS checks the carrier again on its own; you never need to refresh.
- Stop tracking removes a container from your list. It doesn't give back a container of your plan, and tracking the same container with the same carrier again later doesn't use a new one.
- Check numbers before you track them: a wrong number that looks valid still uses one container of your plan.
5. Status and dates
Every answer is based on what the carrier reported. CTMS gives Claude the date the carrier's data last changed, so you can see how fresh it is (CTMS checks more often than that).
| Status | Meaning |
|---|---|
| Waiting for first update | Just added; the carrier hasn't returned events yet. |
| Booked | Only planned events so far. |
| In transit | The carrier reports events; the container is on its way. |
| Arrived | Discharged at the port of discharge; the journey isn't closed yet. |
| Journey complete | The journey is finished and the carrier is no longer checked. |
| Cannot be tracked | CTMS couldn't find this number at the carrier. Check the number and the carrier. |
- ETA is the estimated arrival at the port of discharge, as the carrier publishes it.
- Milestones: gate in, loaded, departed, transshipment, arrived, discharged, gate out, with dates and places, plus the next expected event.
- ETA changes: when the carrier has moved the ETA, CTMS lists the earlier ETAs, so Claude can tell you how many days it slipped. Hapag-Lloyd doesn't publish the data for this.
6. Free time (demurrage & detention)
Tell Claude your free days per carrier, from your contract or the carrier's tariff. CTMS then works out the last free day and the days left for your containers of that carrier, and can tell you which ones run out of free time soon or are already being charged.
- Free days can apply to a whole carrier or only to one port or box type, for import or export.
- Free days can be calendar days or working days (Monday–Friday, Monday–Saturday or Sunday–Thursday).
- Combined demurrage and detention free days, or separate numbers for each.
- CTMS never assumes free days: without saved free days for a carrier, there's no last free day for its containers.
The last free day and days left are estimates from the free days you saved and the carrier's events. The charges you owe are set by your carrier, terminal or port; always check their free time and invoices. See the Terms.
7. What CTMS can do in Claude
| Action | What it does | Changes your account? |
|---|---|---|
| Account and plan | Your plan, containers used and the plan's limit | No |
| Manage subscription | A link to change or cancel your paid plan, update the card or download invoices; on Free, the upgrade link | No |
| List tracked containers | Your containers, filtered by status, carrier, port or arrival dates | No |
| Container status | Status, last and next event, ETA and ports of one container | No |
| Container milestones | The milestones one container has reached and its earlier ETAs | No |
| Free time running out | Containers whose free time ends within a number of days, or that are already being charged | No |
| Saved free days | The free days saved for your account | No |
| Start tracking containers | Tracks up to 20 containers, each with its carrier | Yes: uses containers of your plan |
| Stop tracking containers | Removes containers from your list | Yes |
| Save free days | Saves, replaces or removes the free days for a carrier | Yes |
CTMS sees only the requests Claude sends to these actions, never your chats, files or other connectors.
8. Plans and upgrading
| Plan | Price | Includes |
|---|---|---|
| Free | $0 | 10 automatically tracked containers in total (a one-time allowance, it doesn't reset), status, milestones and free time |
| Pro | $15 / month | 20 new automatically tracked containers every month (containers you already track keep updating), everything in Free |
Prices in USD. Longer subscriptions cost less per month. Cancel anytime.
To upgrade, ask Claude "upgrade my CTMS plan" and open the link; payment is handled by Stripe. To change or cancel later, ask "manage my CTMS subscription". The plan applies to your CTMS account for Claude only. Your containers and their history stay when you change plans. Tracking more than 20 containers a month? Contact us.
9. Disconnecting and your data
- To disconnect, open Plugins in Claude (or Customize → Connectors), choose CTMS and disconnect or remove it. Your CTMS account and its containers stay, and you can connect again at any time.
- A connection you no longer use ends on its own about 30 days after its last use.
- To delete your CTMS account and all its data, write to support@get-ctms.com from the email address you signed in with.
Details are in the Privacy Policy (section 1.I) and the Terms.
Need help?
Email us at support@get-ctms.com. Please include the container number and carrier if your question is about a specific container.