TimePeace connector

What the connector does

It gives your assistant a set of clearly-labelled tools for your TimePeace diary, split across two permissions you choose at connect time:

Reading is genuinely separate: it stays off unless you choose it, and you can connect with adding alone. If your diary is sealed with your own encryption, the reading tools honestly say so rather than returning anything — because on our servers there is nothing readable to return.

Setup — connecting it to your assistant

There are two routes, and which one you use depends on your assistant. In ChatGPT, TimePeace is a published app, so you add it from inside ChatGPT and there is no address to paste. Everywhere else — Claude included — you add the connector yourself, which is the second route below. Either way you'll need a TimePeace account (free — sign up at timepeaceapp.com).

In ChatGPT — add the published app

TimePeace is listed in ChatGPT's own app directory as TimePeace — Daily Log. Find it there, add it, sign in to your TimePeace account and approve the access you want — the same permission screen described below. Nothing to paste, nothing to configure.

See TimePeace in the ChatGPT app directory →

The connector address

This is the URL you paste into your assistant when it asks for a custom connector:

https://mcp.timepeaceapp.com

It's a remote connector, so there's nothing to download or install — your assistant talks to it over the web.

Step by step (Claude, and any other assistant)

1. In Claude, open Settings → Connectors (on the web app: your profile menu → Settings → Connectors).
2. Choose Add custom connector.
3. Give it any name you like (for example, "TimePeace") and paste the connector address above.
4. Click Add, then Connect. Your assistant opens TimePeace's sign-in and permission screen.
5. Sign in to your TimePeace account. If you're already signed in on that device, this is a single tap.
6. On the permission screen, choose Add only or Add and read. This is where you decide whether the assistant may read your diary; you can change it later by reconnecting. Then click Connect.
7. You're returned to your assistant with the connector enabled. Try one of the prompts below.

To turn it off, remove the connector in your assistant, or open Settings → Connected apps in TimePeace and disconnect it there. Either one cuts off access straight away; nothing already in your diary is touched.

Usage — what you can ask

Once connected, you talk to your assistant normally and it picks the right tool. A few examples:

Catch-ups and hangouts

A call, a text or a video call is logged as a catch-up, with the person's name and how you spoke; a coffee, a walk or dinner at a friend's is a hangout, with where you were if you said. Your assistant never links either one to someone on your People page — not even a name that matches, and it never creates a new person. The name stays in the words, so your diary shows a catch-up with Sam, and you can link it to Sam yourself in the app.

Turning a confirmation email into a trip

This is the one worth understanding, because it is where an assistant is most useful and most able to get things wrong. If you ask it to put a booking confirmation into TimePeace, it follows a fixed set of rules rather than interpreting the email however it likes.

• It finds the trip first, and asks if it isn't sure. If you have two trips that could match, it asks which one you mean. If it can't find one at all, it asks whether to start a new trip. It will not attach a booking to whichever trip has the closest dates.
• It copies the reference exactly. For a flight that's the short booking reference, not the ticket number. The reference is also how it recognises the same booking again — so forwarding the same email twice corrects the one booking instead of creating a duplicate.
• Times stay as printed. A flight leaving 18:40 is recorded as 18:40. It doesn't convert timezones, and if no time is printed it leaves the time blank rather than guessing one.
• A booking doesn't silently redraw your route. If a flight goes somewhere your trip has no leg for, it suggests adding that leg and waits for you — because legs drive your day counts and visa prompts.
• Marketing isn't a booking. Fare alerts, price drops and suggested itineraries are ignored. A cancellation isn't a new booking either — it asks what you want done with the existing one.

TimePeace also spots bookings arriving in your own inbox and offers them for you to approve. An assistant writing a booking directly checks what's already on the trip first, so the two don't collide. Either way, everything an assistant changes is listed for you, and you can undo it.

How it decides where things go

Whatever files something into your TimePeace — the app's own sorting, or an assistant you connect — follows the same written rules. These are those rules, in the same words the assistant is given. Every one comes with an example, so you can tell when it has got something wrong; and everything it files is listed for you, with a reason and an undo. The reason is never written freehand: each rule below ends with the only words it may give you, so a line on your receipt can always be traced back to the rule that filed it.

The laws above every area

• Fresh words only. The assistant files what the person just said and nothing else. It never reaches into their history to decide, never adds a detail they didn't say, and never invents a number — an amount, a distance, a duration, a time, a page count. Missing is missing. e.g. "Ran this morning" → exercise, running, no distance, no time. On your receipt: “because only what you said”
• One thing per item, and nothing without a keep. Each thing the person said becomes exactly one entry, in the place it belongs. Nothing files without the person's say-so: under "Ask me first" it waits for their yes; under "File it and show me" every change lands on their receipt with its reason and an undo. Nothing is ever deleted on the strength of what someone said. e.g. "Gym, then coffee with Dave, then paid the electricity" → three entries: exercise · hangout with Dave · purchase. On your receipt: “because one entry per thing”
• Ambiguity is a question, never a guess. When the words could mean two different people, trips, courses or days, the assistant asks — in the review, or parked on the receipt when hands-free. It never picks the likelier one, never creates a new one to avoid choosing, and never files against the wrong one "for now". e.g. "Booked the car in before the trip" with two trips ahead → a parked question: which trip? On your receipt: “because two could match”
• Tense decides log or plan. Past tense, or a time of day that has passed today, means it happened — a diary activity on that day. Future tense, "tomorrow", a named day ahead, or "need to" means it hasn't — a plan if it has a date, a task if it doesn't. Dates are read against today; "Tuesday" is the next Tuesday unless they said "last". e.g. "Dentist at four" said at 9am → a plan today at 16:00; said at 6pm → an appointment logged at 16:00. On your receipt: “because you said it happened” · “because you said it's ahead”
• Times and dates only when said. A time is recorded only when the person gave one; a duration only when they gave one; a date only when they named or implied one (else today). "This morning" is not a time. "An hour" is a duration. Nothing is rounded to a nicer number. e.g. "Called Mum for about an hour this morning" → catch-up, phone call, 60 minutes, no clock time. On your receipt: “because time as you said it”
• The person's words stay theirs. A diary line keeps the person's own words, lightly tidied (capital letter, full stop), never rewritten, shortened, translated or summarised. An entry's title is short and concrete in their vocabulary. e.g. "honestly a bit of a nothing day, walked to the shops, felt flat" → a diary line with those words (see D1 for the mood). On your receipt: “because kept in your words”
• Nothing structured from a passing mention. A trip, a course, a habit, a routine, a budget, a bill, a person's page, a timetable — anything with its own shape — is never created from a sentence that merely mentions it. Those are set-ups: the assistant shows the whole set of changes first (the bundle), or, until bundles exist, files the words as a diary line and says so. e.g. "Going to Cape Town in March for a wedding" → today: a diary line saying so; with bundles: a trip preview (dates, legs, packing list started, leave) shown before anything files. On your receipt: “because set-ups are shown first”
• Other is last, and says so. When nothing fits, the entry is filed as a diary line — the app's "Other" — in the person's words, and the reason says nothing closer fits. Other is never chosen to avoid a decision; every rule above is tried first. e.g. "Sorted the garage" → a diary line "Sorted the garage" (there is no chores type yet — what lands here in aggregate is how new types are earned). On your receipt: “because nothing closer fits”

Choosing the activity

• A phone call is a catch-up; a coffee is a hangout. Contact by any channel — a call, a text exchange, a video call, a voice note, an email, a message thread, bumping into someone — is a catch-up with that person and the channel named. Being together in person somewhere — a coffee, a drink, a walk, a visit, dinner at theirs — is a hangout with that person and the place if they named one. You spoke or you met: that is the whole difference. (needs People switched on) e.g. "Called Dave about the weekend" → catch-up with Dave, phone call. On your receipt: “because you spoke, you didn't meet” · “because you met in person”
• Movement said in passing is exercise. A run, a swim, a ride, a gym session, a class, a match, a hike, a climb — mentioned in passing or not — is exercise, with the sport named as they said it and the distance or minutes only if they said them. A walk is exercise only when they treat it as one ("went for a walk", "walked 5k"); walking to the shop is not. (needs Exercise switched on) e.g. "Quick 5k before work then meetings all day" → exercise, running, 5 km; work. On your receipt: “because you moved, so it's exercise”
• A sick day is time off, not a diary line. "Off sick", "ill", "flu", "stayed in bed with a cold" is a sick day — time off of the sick kind, with the illness in their words — never a bare diary line. A whole stretch ("off sick Monday to Wednesday") is one sick day per working day. Sick days never touch a leave balance. (needs Time off switched on, health data allowed) e.g. "Off sick today, stomach bug" → time off, sick, illness "stomach bug". On your receipt: “because sick is time off”
• Leave is leave, and a bare day off is leave. "On leave", "holiday", "annual leave", "took the day", "day off" is leave — a full day unless they said a half or the hours — against the bank they named, else the default bank. The word "sick" or an illness is what makes it a sick day; without one, it's leave. (needs Time off switched on) e.g. "Took Friday off" → leave, Friday, full day. On your receipt: “because you said off, not sick”
• A purchase goes to Money when Money is on. Spending money — bought, paid, ordered, a fee, a ticket — is a purchase with the amount and the category as best the words give it, in the currency they said if abroad. When Money is switched off the type does not exist: the words stay in the diary line and the reason says Money is off. (needs Money switched on) e.g. "Paid R450 for the vet" → purchase, R450, category pets (or their nearest), note "vet". On your receipt: “because money out goes to money”
• Eating is a meal, and how it arrived matters. Cooked something — a meal of the cooked kind, the dish named, matched to a recipe only when the name matches one they have. Had leftovers — the leftovers kind. Ordered in — takeaway with the place. Ate out — restaurant with the place. "With" someone makes them the meal's people. (needs Food switched on) e.g. "Made a big lasagne, froze half" → meal, cooked, "lasagne", two portions frozen if they said the number. On your receipt: “because you ate, and how”
• Screens, pages and music. Watched a series or a film — watching, with the title, the season and episode only if said, a rating only if said, the people if named. Read a book — reading, matched to a book on their shelf by title, pages if said; an article is reading of the article kind. Practised an instrument — music practice; listened — music listening; a gig or show attended — a live event with the act and the venue. (needs Media switched on (watching, reading, music)) e.g. "Two episodes of Slow Horses" → watching, series "Slow Horses", two episodes. On your receipt: “because it's what you watched” · “because it's what you read” · “because you played, you didn't listen”
• Work, shifts and appointments. A working day or stint is work, with hours if said. A rostered shift — early, day, late, night — is a shift. A booked slot with someone or something — dentist, doctor, barber, a meeting with a named person, a viewing — is an appointment with the kind and the time. e.g. "Worked from home, about six hours" → work, 6 hours, place home. On your receipt: “because it's your working day” · “because a booked slot”
• Study is a session; the course is matched, never made. Studying is a study session with the subject and minutes if said; it links to a course only when the name matches one they have. A new course name is never created from a mention (Z6). e.g. "Two hours on stats" → study, subject "stats", 120 minutes, linked to the course if one matches. On your receipt: “because a study session”
• A hobby is time on the thing you make. Time on a named craft, project or pastime — painting, woodwork, coding for fun, the garden, the model railway — is a hobby entry, with the hobby named as they said it and minutes if said. (needs Hobbies switched on) e.g. "An hour in the garden" → hobby, gardening, 60 minutes. On your receipt: “because time on your hobby”
• A milestone is a marker. Something that happened once and matters — got the job, passed the test, moved in, the baby arrived — is a milestone with the kind and their words, not a diary line. e.g. "Passed my driving test!" → milestone, "passed my driving test". On your receipt: “because a day to remember”
• A leg travelled is a journey. A flight, train, drive, bus or ferry the person took is a journey with the mode and where to (where from if said), joined to the trip covering that day when there is one. It is never a trip by itself (T1). e.g. "Flew back from Joburg" → journey, flight, to home, from Johannesburg. On your receipt: “because a leg you travelled”
• Drinks are counters, not diary lines. Water, coffee and tea counts go to the day's drink counters, never into the diary as lines. When the counters can't be reached the words stay in the diary line and nothing is counted. e.g. "Three coffees today" → coffee ×3 on the day's counters. On your receipt: “because counted, not written”

The diary line and the mood

• How the day felt is the mood, and stays in the words. When the person says how the day felt — flat, great, rough, a good one — that sets the day's mood (one to five, five is a great day) and the words also stay in the diary line. A feeling about one thing ("nervous about the interview") is not the day's mood. The mood is set only when the day has none; it never overwrites one the person set. (needs health data allowed) e.g. "Feeling a bit flat today" → mood 2, and the line "Feeling a bit flat today". On your receipt: “because you said how today felt”
• The rest of the day is one line, in their words. Whatever isn't an activity, a task, a plan or a mood becomes a diary line in the person's own words (Z5). One dump makes one diary line per distinct thought, not one per sentence. e.g. "Grey day. Lots of small admin. Missed the gym." → one diary line; "missed the gym" is not exercise. On your receipt: “because your own words”

People

• A name the app knows is attached; a new name is not invented. A hangout, catch-up, meal or watch "with" a person the app knows attaches that person. A name the app doesn't know is kept in the words and, when the sentence is clearly about that person (a catch-up, a hangout), becomes a question: add them? Never a silent new person. e.g. "Coffee with Dave" (Dave known) → hangout with Dave. On your receipt: “because a person you know”
• A fact about someone goes on their page. Something learned about a person — a new baby called Ella, a new job, moved to Durban — is a moment on that person's page, dated today, in the person's words. Their birthday, when said, is set on their page. A gift they let slip they want is a gift idea on their page. (needs People switched on) e.g. "Dave's got a new baby called Ella" → a moment on Dave's page: "new baby called Ella". On your receipt: “because it's about them”
• A follow-up is a task that names them. "Should get coffee with Dave", "must call Gran" is a follow-up: a task naming the person, undated unless they said when. It does not change the person's cadence; that is a setting they choose. e.g. "Should get coffee with Dave" → task "Coffee with Dave", follow-up. On your receipt: “because something to do with them”
• A plan with people is a plan, a party is an occasion. A dated thing with named people — dinner Friday with Sam — is a plan with those people. A gathering the person is hosting or organising, with several people and RSVPs, is an occasion — a set-up (Z6), shown first. e.g. "Dinner with Sam on Friday" → a plan Friday, hangout, with Sam. On your receipt: “because a plan with them”

Travel

• A trip has legs, a prep list and a packing list — and is never made from a mention. A trip is a set-up: dates, the places (legs), what to do before (prep), what to take (packing). It is created only through a bundle the person sees whole. A mention ("off to Cape Town in March") is a diary line until then. A day out is not a trip. (needs Travel switched on) e.g. "Wedding in Cape Town in March" → today: a diary line; with bundles: trip preview. On your receipt: “because trips are set up, not guessed”
• Before-the-trip things go on the trip's prep list. Something to do before a trip — book the car in, sort the visa, buy adaptors — is a prep item on the trip it is for: the one upcoming trip if there is one, a question if there are two (Z2). "Remember to pack …" is a packing item on that trip. (needs Travel switched on) e.g. "Need to book the car in before the trip" (one trip ahead) → prep item "Book the car in" on that trip. On your receipt: “because to do before the trip”
• A booking is a booking, and a leg is suggested, never assumed. A confirmation — flight, hotel, hire car — is a booking on the trip with the reference as printed and times as printed (no time-zone conversion). A flight to a place the trip has no leg for suggests the leg and waits; it never redraws the route. (needs Travel switched on) e.g. "Hotel in Porto confirmed, ref ABC123, 14–16 May" → booking on the trip, ref ABC123, dates as printed; Porto not a leg → suggest adding it, wait. On your receipt: “because booked, as printed”
• A day on a trip is a moment. While a trip is on, "today we …" is a trip-day entry in their words on that day, joined to the trip. (needs Travel switched on) e.g. (on the Lisbon trip) "Trams, custard tarts, sunburn" → a trip-day line on the Lisbon trip. On your receipt: “because a day on your trip”

Plans, tasks, routines and the shopping list

• Dated is a plan, undated is a task, repeating is a routine. Something to do with a date (or a day name) is a plan on that date with the time if said. Something to do with no date is a task, with a due date only if they said one. Something that repeats — every Monday, three mornings a week — is a routine, which is a set-up (Z6): shown first, never created from a mention. e.g. "Call the bank tomorrow" → a plan tomorrow, "Call the bank". On your receipt: “because dated, so a plan” · “because undated, so a task” · “because repeats, so a routine”
• A plan is typed when the words say what kind. A plan carries the activity type the words imply — a run is exercise, a dentist is an appointment, dinner with Sam is a hangout — so ticking it later opens the right screen. When nothing is implied it is a plain plan. e.g. "Run with Priya Saturday morning" → a plan Saturday, exercise, running, with Priya. On your receipt: “because planned as what it is”
• Groceries go to the shopping list, one item each, in the right section. "Need milk, coffee and olive oil" is three items on the shopping list, each in the section the list already has for it (dairy, drinks, …) when it can tell, unsectioned when it can't. Never a task called "groceries". (needs Food switched on) e.g. "We're out of milk and the good olive oil" → shopping list: milk (dairy) · olive oil (pantry). On your receipt: “because it's a shopping item”
• A reminder is a plan with a time, not a notification. "Remind me to …" becomes a plan (dated, timed if said) or a task (undated) like anything else; the app's own rules decide what it says and when. The assistant never promises a message. e.g. "Remind me to take the bins out tonight" → a plan today, evening, "Take the bins out". On your receipt: “because a reminder is a plan”

Habits and quitting

• A habit is a rhythm, not a streak. A habit is "N days a week", kept week by week; a missed day is not a broken chain, and a quiet week restarts kindly. The assistant speaks of a habit in those terms — kept this week, back on it — never "streak broken". A new habit is a set-up (Z6). (needs Habits switched on) e.g. "Did my meditation" (a habit called meditation exists) → today's check on that habit. On your receipt: “because a rhythm, kept weekly”
• A slip on something you're quitting is said kindly. "Had a cigarette", "broke my no-sugar thing" against something the person is quitting is a slip on that quit, recorded plainly and never with a judgement; the words stay theirs. (needs Quit switched on, health data allowed) e.g. "Had two glasses of wine, so much for dry January" → a slip on the alcohol quit, note in their words. On your receipt: “because a slip, not a failure”

Studies

• Sessions go to the diary, classes and exams to the timetable. A study session is a diary activity (A9). A class that repeats is a timetable entry and an exam or assessment with a date is an assessment on the course — both set-ups (Z6), shown first. A study slot the person intends ("stats tonight, two hours") is a plan. (needs Studies switched on) e.g. "Stats lecture is Tuesdays and Thursdays at ten" → today: a diary line; with bundles: two timetable rows. On your receipt: “because classes live on the timetable”

Money

• Category from the words, amount as said, currency as said. A purchase takes the category its words imply from the person's own categories — groceries, transport, eating out, pets — and a nearest-fit only when one is clear; otherwise no category, and the reason says so. The amount is exactly what they said; a currency named abroad is kept as the local amount. (needs Money switched on) e.g. "R1,200 on groceries at Woolies" → purchase R1200, groceries, note "Woolies". On your receipt: “because money out, as you said it”
• Bills, budgets and splits are set-ups. A recurring bill, a budget, a shared cost to split — anything with its own shape in Money — is a set-up (Z6). "I paid for both of us" goes in the purchase's note, never a split. (needs Money switched on) e.g. "Paid for dinner for both of us, R600" → purchase R600, note "for both of us"; no split. On your receipt: “because shown before it changes money”

What the assistant never does

• Never a number it wasn't given. No estimated amounts, distances, durations or times; no "about an hour" turned into 60 unless they said an hour; no page counts, no calories, no steps. e.g. "Went for a run" → exercise, running, no distance, no minutes. On your receipt: “because never a guessed number”
• Never a deletion, and the person's hand always wins. The assistant adds and files; it never deletes a whole thing — an entry, a plan, a person, a trip — without the person's yes. When it changes something the person made, it changes only what it read, skips anything the person has changed since, and lists every change with an undo. A correction to its own filing is a re-file on the receipt, never a quiet edit. e.g. "Actually delete yesterday's gym entry" → nothing is deleted; the assistant says how to undo it themselves. On your receipt: “because it adds, it doesn't remove”
• Never a message to anyone else. "Tell Sam I'm running late" is a task or a plan for the person, never a message sent. The assistant drafts; the person sends. e.g. "Tell Sam I'll be late" → task "Tell Sam I'll be late". On your receipt: “because you send, it drafts”
• Never a person, place, course, habit or trip it wasn't sure of. See Z2 and Z6. Matching is by name against what the person already has; a near-miss is a question, and a set-up is shown whole first. e.g. "Lisbon trip" with a "Lisboa 2025" trip in the past → a question, not a match. On your receipt: “because asked, not assumed”

The tools, and how they're labelled

Your assistant shows each tool with a title and marks whether it reads or writes, so you always know what an action will do. Reading tools are marked read-only; adding and removing tools are marked as writing.

The read tools work only when you granted the reading permission and your diary is not sealed with your own encryption. Otherwise they decline plainly and adding continues to work.

Privacy — what the connector can and can't do

The connector is built the same way as the rest of TimePeace: you stay in control of your own diary, and the assistant only ever gets what you deliberately grant it. In plain terms:

• You grant it, and you can revoke it. Nothing is connected until you sign in and approve it, and you can disconnect any time from your assistant or from Settings → Connected apps. Removing it stops access straight away.
• Adding and reading are separate. Adding is on when you connect; reading is off unless you tick it. You can connect for adding alone and never let the assistant read a thing.
• What it adds is marked, and reversible. Every entry the assistant creates is stamped as coming from it. It can remove only its own additions — never your hand-written entries. If you edit an entry it added, that entry becomes yours and the assistant can no longer touch it.
• It never links anyone. A catch-up or a hangout it adds keeps the other person's name in the words only — it is never tied to someone on your People page, and it never creates a person.
• Reading leaves out your time with other people. A catch-up or a hangout is about someone else as well as you, so a reading assistant is not shown them — and there is no permission yet that would let it.
• Encryption is honoured, not bypassed. If you've sealed your diary with your own passphrase, our servers hold only ciphertext they cannot read — so the reading tools return an honest "this diary is sealed" instead of your content. The connector never weakens your encryption.
• Nothing is sold or shared. Your diary is yours. Connecting an assistant does not put your entries on any public shelf, hand them to an advertiser, or sell them. The assistant reads only what you asked it to, for the request you made.
• Signing in is standard and scoped. The connection uses a standard sign-in handshake (OAuth) over an encrypted connection; the assistant receives a permission token scoped to exactly what you granted, and never your password.

The connector is a user-directed tool: you choose to connect it, you choose what it may do, and you can cut it off whenever you like. For the full picture, our privacy policy and terms apply, and how we protect your data explains the encryption in plain language.