MCP Server Setup

Camper Split supports the Model Context Protocol (MCP), allowing you to interact with your vehicle data directly from Claude AI. Log trips, check balances, and manage your vehicle using natural language.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and data sources. By setting up the Camper Split MCP server, you can use Claude to interact with your vehicle data.

For example, you can ask Claude: "Start a trip called Weekend getaway with odometer 52340" or "What is my current balance?" and it will execute the action through Camper Split's API.

Prerequisites

Before setting up the MCP server, make sure you have:

A Camper Split account with at least one vehicle
Claude Desktop (macOS/Windows) or Claude Code installed
Your Camper Split OAuth credentials (generated below)

Step 1: Generate OAuth Credentials

To connect Claude to Camper Split, you need OAuth credentials. These allow Claude to securely access your account.

1Sign in to Camper Split and go to your Profile page
2Scroll down to the "API Access" section
3Click "Generate MCP Credentials"
4Copy the Client ID and Client Secret — you will need them in the next step

Keep your Client Secret secure. Do not share it or commit it to version control.

Step 2a: Configure Claude Desktop

If you are using Claude Desktop, add the following to your claude_desktop_config.json file:

On macOS, the config file is located at:

~/Library/Application Support/Claude/claude_desktop_config.json

On Windows, the config file is located at:

%APPDATA%\Claude\claude_desktop_config.json

Add the Camper Split MCP server configuration:

{
  "mcpServers": {
    "campersplit": {
      "command": "npx",
      "args": ["-y", "@campersplit/mcp-server"],
      "env": {
        "CAMPERSPLIT_CLIENT_ID": "YOUR_CLIENT_ID",
        "CAMPERSPLIT_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

Replace YOUR_CLIENT_ID and YOUR_CLIENT_SECRET with the credentials you generated in Step 1.

Restart Claude Desktop for the changes to take effect. You should see the Camper Split tools appear in the tools menu.

Step 2b: Configure Claude Code

If you are using Claude Code, add the MCP server using the CLI:

Terminal

claude mcp add campersplit \
  --command "npx -y @campersplit/mcp-server" \
  --env CAMPERSPLIT_CLIENT_ID=YOUR_CLIENT_ID \
  --env CAMPERSPLIT_CLIENT_SECRET=YOUR_CLIENT_SECRET

This command registers the Camper Split MCP server. Claude Code will prompt you to authorize the connection on first use.

Available Tools

Once connected, the following tools are available to Claude:

list_vehiclesList all vehicles you have access to

get_vehicleGet details of a specific vehicle

start_tripStart a new trip with a title and odometer reading

end_tripEnd an active trip with the final odometer reading

log_refuelingLog a fuel-up with volume, cost, and odometer

log_maintenanceRecord a maintenance expense

get_costsView the cost overview and member balances

get_tripsList all trips for a vehicle

Use Cases

Here are some examples of what you can do with the MCP integration:

Quick trip logging

"Start a trip called Grocery run, odometer is 51200" — Claude starts the trip instantly.

Balance checks

"How much do I owe for our camper?" — Claude fetches your current balance.

Expense logging

"I just refueled 45 liters for 82 euros at 51450 km" — Claude logs the fuel-up.

Cost summaries

"Give me a summary of all costs this month" — Claude pulls the cost data and summarizes it.

Troubleshooting

Claude does not show Camper Split tools

Make sure you have restarted Claude Desktop after editing the config file. Check that the JSON is valid and the file path is correct.

Authentication errors

Verify your Client ID and Client Secret are correct. If you regenerated your credentials, update the config file with the new values.

Tools are listed but commands fail

Check that your Camper Split account has the required permissions. You need to be an owner or user of the vehicle you are trying to access.

Connection timeout

The MCP server requires an internet connection. Make sure you are online and that campersplit.com is accessible.