TripLedger

TripLedger MCP server

A remote MCP server for your personal travel history. Connect Claude, ChatGPT, Cursor or any MCP client to TripLedger and keep a durable ledger of where you've been: journeys, stays and travel expenses, with tax-residency day counts and Schengen 90/180 status computed from your records.

• Endpoint: https://my.tripledger.app/mcp (Streamable HTTP)
• Auth: OAuth 2.1 (browser consent) or a tl_ API key
• Docs: docs.tripledger.app

This repository contains connection instructions and configuration only. TripLedger is a hosted service; nothing here runs locally.

What you can ask

• "Log my flight from this booking email: LHR → BCN on 14 March, back on the 21st."
• "How many Schengen days do I have left if I travel to Lisbon on 2 June?"
• "How many days have I spent in Spain this year, and in the last 365 days?"
• "Where am I according to my travel ledger?"
• "Find gaps in my 2025 travel history before I send it to my accountant."

Connect

Claude.ai / Claude Desktop (OAuth)

1. Settings → Connectors → Add custom connector
2. Paste https://my.tripledger.app/mcp
3. Log in to TripLedger and approve. Each grant binds one ledger.

Claude Code (API key)

Create a key in TripLedger under Settings → API keys (shown once), then:

claude mcp add --transport http tripledger https://my.tripledger.app/mcp \
  --header "Authorization: Bearer tl_YOUR_KEY"

Other MCP clients

Clients that support remote OAuth: configs/mcp-oauth.json. Clients that need a header: configs/mcp-api-key.json.

Treat API keys like passwords. Revoke keys and OAuth grants anytime in TripLedger Settings → API keys / Connected apps.

Tools

Read

Tool	What it does
get_profile	Connected ledger and credential scope
get_tripledger_guide	Operating guide for agents
get_journey_review	Booked journeys that are now overdue for confirmation
search_locations	Cities by name or airport code
list_people	Travelers in the ledger
list_journeys / get_journey	Journeys (the presence record)
list_stays / get_stay	Accommodation
list_expenses	Costs attached to journeys and stays
list_loyalty_programs / list_loyalty_accounts	Loyalty programs and accounts (numbers masked)
get_travel_summary	Days per country
get_residency_status	Days against configured tax-residency thresholds
check_schengen_status	Rolling Schengen 90/180 status
get_current_country	Current country from recorded journeys
detect_journey_gaps	Missing movements that make counts uncertain
get_methodology	How every count is calculated

Write

log_journey, update_journey, delete_journey, log_stay, update_stay, delete_stay, log_expense, update_expense, delete_expense, create_loyalty_account, update_loyalty_account, delete_loyalty_account, set_journey_preferences.

Live tool schemas from the server are authoritative.

Access and pricing

• 14-day trial, then a one-time $97 lifetime license per ledger. No subscription.
• After a trial ends the ledger is read-only: reads, calculations and MCP read tools keep working.
• 5,000 MCP requests per ledger per day.
• Writes need an owner or editor role; viewers get read tools.

Agent plugin

plugin/ is an Agent Plugins package: the MCP server plus a managing-tripledger workflow skill that teaches agents to capture travel from evidence, never invent records, and confirm before deleting.

Not

TripLedger is a ledger, not flight or hotel search, a booking service, or live location tracking. Results depend on the travel you record. They are informational, not tax or legal advice, and not a guarantee of admission at any border.

Links

Website · Docs · Schengen tracking · Tax-residency day counter · Privacy · Terms · [email protected]

Made by Pianosa Labs.