What Does This Actually Do?

You already use Self Employment Toolkit to track mileage, log expenses, and send invoices. With an integration, your AI assistant can read and update that same data just by having a conversation with you.

Think of it like giving Claude a read/write connection to your bookkeeping. You can ask it anything: "How much did I spend on travel last quarter?" or "Log a $47 lunch expense with Acme Corp." No copy-pasting, no switching apps.

Connect in 3 Steps

1. Get an API key. Go to your Settings page, scroll to API Keys & Integrations, and click + Generate Key. Give it a name like "Claude Desktop" and copy it right away. You won't see it again.
2. Pick your tool. Use Claude Desktop for conversation, or n8n and Make for automatic workflows. Follow the setup guide for your tool below.
3. Start asking questions. That's it. Your AI tool now has live access to your mileage, expenses, invoices, clients, and time entries.

Set Up Claude Desktop

Claude Desktop is a free app from Anthropic for Mac and Windows. Open it, click the plug icon in the toolbar (or go to Settings → Integrations), and click Add custom connector. You'll see a dialog like this:

Fill in two fields and leave everything else blank:

• Name: anything you like, e.g. Self Employment Toolkit
• Remote MCP server URL: https://selfemploymenttoolkit.com/mcp?key=skt_your_api_key_here

Replace skt_your_api_key_here with the key you copied from Settings. Leave the OAuth fields blank and click Add. Claude connects immediately and you can start asking questions like:

• "What did I spend on software subscriptions last month?"
• "Log a $62 meal expense with Acme Corp from today."
• "How many business miles did I drive in April?"
• "Show me all unpaid invoices."

Set Up Claude.ai (Web)

If you use Claude in your browser at claude.ai, you can connect your data directly from the settings panel. No config file needed.

Set Up n8n or Make

For no-code automation workflows, use n8n's HTTP Request node or Make's HTTP module. A common pattern: a Google Calendar event fires, n8n reads the event details and automatically logs a mileage trip in your account, no manual entry needed.

• Method: POST
• URL: https://selfemploymenttoolkit.com/mcp
• Header: Authorization: Bearer skt_your_api_key_here
• Body: JSON-RPC 2.0 format (see the technical reference below)

Protocol Overview

The Self Employment Toolkit implements the Model Context Protocol (MCP) Streamable HTTP transport (spec version 2025-03-26). The endpoint is a stateless HTTP server that accepts JSON-RPC 2.0 requests and returns either application/json or text/event-stream responses depending on the client's Accept header.

Authentication uses a Bearer token in the Authorization header. Tokens have the prefix skt_ followed by 64 hex characters (32 random bytes). The raw token is shown once at creation time; only a one-way hash is stored server-side. Tokens can be revoked at any time from Settings.

All 11 MCP Tools

Six read tools return JSON arrays or summary objects. Five write tools create or update records and return the new record's ID.

Tool	Type	Description	Parameters
get_overview	Read	YTD summary: revenue, mileage, trip count, active clients.	none
list_clients	Read	All clients: name, address, hourly rate, notes. Up to 200.	none
list_expenses	Read	Expenses filtered by date range or category. Up to 200.	start (YYYY-MM-DD), end, category
list_trips	Read	Mileage trips with distance, category, addresses. Up to 200.	start, end, client_id
list_invoices	Read	Invoices with status, total, client, due date. Up to 200.	status (draft | sent | paid | void), client_id
list_time_entries	Read	Time entries with client, date, clock-in/out. Up to 200.	start, end, client_id
log_expense	Write	Creates an expense record. Amount in integer cents.	amount_cents*, date* (YYYY-MM-DD), category*, vendor, notes, client_id
log_trip	Write	Creates a mileage trip record.	start_time* (ISO 8601), end_time*, distance_miles*, start_address, end_address, category, client_id
log_time	Write	Creates a time entry (HH:MM 24-hour clock).	date* (YYYY-MM-DD), clock_in* (HH:MM), clock_out*, notes, client_id
create_draft_invoice	Write	Creates a draft invoice with line items.	client_id*, issued_date*, line_items* (array), due_date, notes
mark_invoice_paid	Write	Transitions a sent invoice to paid status.	invoice_id*, paid_at (YYYY-MM-DD, defaults to today)

* Required parameter.

Rate Limits

All calls (read and write) count toward the 120/min limit. Write operations are not separately rate-limited beyond the overall cap. Rate limit windows are fixed (not sliding). Exceeding a limit returns HTTP 429.

Wire Format

All requests are JSON-RPC 2.0 POST to https://selfemploymenttoolkit.com/mcp. Set Authorization: Bearer skt_... and Content-Type: application/json. Include Accept: application/json, text/event-stream for MCP-compliant clients.

List expenses with date filter:

Log an expense (amount in cents):

Discover available tools:

Security

API keys are hashed with SHA-256 before storage. The raw key is shown exactly once at creation time. Every response is scoped exclusively to the authenticated account; no tool can access another user's data regardless of the arguments passed. Rate limits are enforced per key, so a runaway workflow on one key does not affect others on the same account.

The MCP endpoint runs behind the same DDoS protection and TLS termination as the rest of the service. All data in transit is encrypted.

Frequently Asked Questions