DrillerDB Connector for Claude (MCP)

Model Context Protocol (MCP) connector

The DrillerDB connector lets you work with your DrillerDB account directly from Claude. It is a first-party remote server operated by DrillerDB; there is no local package to install. Ask about your drilling jobs, customers, invoices, and accounts receivable in plain English, query well-log and project history, and - with your approval - update job status, schedule and dispatch crews, or send a customer invoice.

New to the integration? Start with the AI Assistant overview for what it can do, example prompts, and how approvals work.

Before you connect

You need an active DrillerDB account with access to your company's data and a Claude account that can add custom connectors. On Claude Team and Enterprise, an organization Owner must add the connector before members connect their own accounts.

You can connect using the server URL below even if DrillerDB does not appear in Claude's directory. Your DrillerDB role and the permissions you authorize determine which tools and records you can access.

Connect in Claude

Use this remote Streamable HTTP server URL:

https://mcp.drillerdb.com

In Claude, open Customize > Connectors, select the + button, then Add custom connector. For Team or Enterprise, an Owner first opens Organization settings > Connectors and adds a Custom > Web connector.
Name it DrillerDB and paste the server URL above. Leave the advanced OAuth client ID and secret fields blank; DrillerDB supports automatic client registration.
Add the connector, select Connect, and complete DrillerDB's sign-in and authorization screens. Review the requested permissions before granting access.
Return to a Claude conversation and enable DrillerDB in the chat's connector menu. Try a read-only question from the examples below.

Enter your credentials only on DrillerDB's sign-in page, not in the chat. For current Claude menus and plan requirements, see Anthropic's custom connector guide. For other clients, use our MCP setup guide.

Try a read-only question

"List my active DrillerDB projects."
"Show my company's accounts receivable aging."
"What is on our crew schedule this week?"

Compare the result with the same project, invoice, or schedule in DrillerDB. An empty result can be valid when your company has no matching records; tools may also be limited by your role.

Permissions (OAuth scopes)

mcp:read - read your projects, customers, invoices, proposals, schedule, equipment, communications, and well logs
mcp:write:low - notes, field reports, and route planning
mcp:write:high - project status changes, scheduling, dispatch, vendor bill import, and sending documents
mcp:proposals:write - proposal actions. Reserved: no tool currently available to external clients uses this scope.

Actions that contact a customer, move a crew, or affect billing (sending an invoice, scheduling or dispatching a job, importing a vendor bill, changing a job's status) are approval-gated: they pause for your explicit confirmation in DrillerDB before execution. OAuth permission and Claude's tool permission do not replace that approval.

Approve a requested change

Open AI agent approvals in DrillerDB using the same account you connected to Claude.
Under Connected app requests, review the target record and proposed change, then choose Approve or Deny.
After approving, return to Claude and ask it to retry the same action. Approval grants permission; it does not itself execute the action. If the request has expired, ask Claude for a new one.

Notes, field reports, and route planning can run without this extra approval when your role and authorized scopes allow them. Review the tool request in Claude before allowing it.

Available tools

The external catalog contains 45 tools. Claude may show fewer based on your DrillerDB role and authorized scopes.

Read (37)

list_my_projects, get_project_detail, list_projects_by_customer, get_project_financials, get_job_profitability, list_customers, list_contacts, list_invoices, get_invoice_detail, list_proposals, get_proposal_detail, get_company_proposal_habits, get_quote_detail, get_quote_engagement, list_work_orders, get_work_order_detail, list_crews, query_schedule, list_field_reports, list_project_files, list_communications, get_communication_detail, list_equipment, get_equipment_detail, get_maintenance_due, list_inventory, list_timecards, get_timecard_summary, get_compliance_form, get_project_compliance_status, query_well_logs, get_geology_at_location, customer_ltv_report, total_billed_by_contact, revenue_pipeline, ar_aging_report, run_report

Write (8)

attach_note_to_project - Add a note to a project
submit_field_report - Submit a field report
plan_crew_route - Plan a crew's route for the day
update_project_status - Change a job's status (approval-gated)
schedule_project - Schedule a job (approval-gated)
dispatch_project - Dispatch a crew to a job (approval-gated)
import_vendor_invoice - Import a vendor bill (approval-gated)
send_invoice - Email an invoice to a customer (approval-gated)

Security & privacy

Tenant isolation: every request is scoped to your company, derived from your sign-in - never from tool input.
Approval gating: customer-facing and billing actions require your confirmation before running.
Audit log: every tool call records who, what, when, and the outcome.
Disconnecting: remove the connector in Claude to stop using it there. Contact support if you also need help revoking its DrillerDB authorization.

Data handling for the connector is described in our Privacy Policy (section 5.7). Questions: support@drillerdb.com.

Troubleshooting

Connector won't connect / authentication fails: make sure you entered the server URL exactly as https://mcp.drillerdb.com (no trailing path), then complete the OAuth sign-in with your DrillerDB email and password. The connector uses OAuth 2.0 - it never asks for an API key.
"Sign in" loops or the authorize screen doesn't appear: confirm you can sign in at console.drillerdb.com, complete any required verification, then retry the connection. If sign-in still fails, contact support with the error message. Keep your account's security protections enabled.
No data / empty results: results are scoped to the company on your DrillerDB account. If a tool returns nothing, confirm the data exists in that company (e.g. open the same list in the DrillerDB app).
A write tool "pauses" or asks for approval: that's expected. Follow the approval steps above, then ask Claude to retry. A request for approval is not a completed action; confirm the final result in DrillerDB.
Tools stop responding / rate limited: the server applies a per-client rate limit and returns HTTP 429 with a Retry-After header; wait and retry.
Disconnect or reconnect: remove DrillerDB under Claude's connector settings. Add it again and sign in to reconnect. For help revoking DrillerDB authorization, contact support.
Still stuck? Email support@drillerdb.com with your Claude client, the step that failed, the error text, and when it happened. Do not include passwords, tokens, or customer records.