Plancraft MCP Server

npx add-mcp 'https://cotlet.dev/mcp/v1/plancraft'

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

Plancraft API and MCP server: Let your AI agent write the offer and chase the invoice.

Plancraft has an API and webhooks for contacts and projects. Its Help Center says the feature is in a test phase, is not available by default and needs some technical knowledge. You create a read or a write API key inside Plancraft. Plancraft has no official MCP server, and no official ChatGPT or Claude connector was found.

Plancraft's API covers only contacts and projects and is not switched on by default (checked 14 Nov 2026). Cotlet runs a hosted Plancraft MCP server with 14 tools that ChatGPT and Claude use in your own Plancraft account. Sent documents, payments and booked hours wait for your OK.

• Free 7-day trial, no card
• Unofficial, not affiliated with Plancraft
• Page: https://cotlet.dev/integrations/plancraft-api-mcp-server

What can your AI agent do in Plancraft?

• Turn site notes into an offer
• Invoice a finished job from its offer
• Remind customers with overdue invoices
• Record this week's bank payments
• Book the crew's hours on the project
• Add a new customer and open the project

Does Plancraft have an MCP server or an API?

• The API has no endpoints for offers, invoices, payments, reminders or working hours.
• Plancraft names Make and n8n for building on the API and gives no support for setting them up.
• An API key is shown in full only once, right after you create it.
• Porta, the "KI-Empfang", answers phone calls for the office; it does not work in your documents.

What you need	Plancraft API	By hand	Cotlet
Ask ChatGPT or Claude to do the work	No official MCP server	Copy and paste	Hosted MCP server
Contacts and projects	Once access is switched on	One screen at a time	Read and create
Offers, invoices and reminders	No endpoints	One document at a time	Drafts, sent after your OK
Payments and working hours	No endpoints	By hand in each list	Recorded after your OK

Checked 14 Nov 2026. Sources: Help: API and webhooks for contacts and projects, Help: Create an invoice in a project, Help: Record working hours and absences, Plancraft features, Plancraft prices, bau.bi on Porta, 20 Mar 2026

How does the Plancraft MCP server work?

1. Log in to Plancraft. Once, in a browser we host for you.
2. Connect your AI agent. One address in its settings.
3. Hand it your site notes. It drafts the offer in the project; you send it.

Your agent works in your own signed-in Cloud Browser. Documents to customers, recorded payments and booked hours wait for your OK.

How to connect Plancraft to your AI agent

1. Sign in to Plancraft in a Cloud Browser. Open plancraft.com/de-de/login in your Cotlet Cloud Browser and log in with your own office user.
2. Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
3. Let the agent in. Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

Plancraft sits on the shared address https://cotlet.dev/mcp/v1 with every other app you turn on, so one connector does it. Turned on Plancraft after connecting? Refresh the connector and its 14 tools appear.

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

Cursor:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: plancraft_read

All 14 Plancraft MCP tools

Built from the Plancraft Help Center, in the order a job runs: customer, project, offer, invoice, payment, reminder. Lists read at once; drafts land in the project for you to check.

Customers and projects

Find or add the customer, open the project with its site address, and read a project's overview.

• List contacts (list_contacts, read): Customers and other contacts, with salutation, name, company and addresses.
• Create contact (create_contact, write): Add a customer contact: a person or a company.
• List projects (list_projects, read): Projects with number, name, customer and status. Filter by status or search by name.
• Get project (get_project, read): One project's overview: description, assigned employees, customer, site address and hours.
• Create project (create_project, write): Open a new project for a customer, with number, description and site address.

Offers and invoices

A blank offer with positions, an invoice made from an offer or order confirmation, and every document in the project folder.

• List project documents (list_documents, read): The documents in one project: offers, order confirmations, delivery notes, invoices and reminders.
• Create offer (create_offer, write): Draft a blank offer in a project with positions: text, quantity, unit and unit price.
• Create invoice from document (create_invoice_from_document, write): Create an invoice from an offer, order confirmation or delivery note in the same project.
• Send document (send_document, write, asks first): Send an offer, invoice or reminder from plancraft to its recipient.

Payments and reminders

The "Ausgangsrechnungen" list by status, payments with Skonto or retention, and the reminder, then the 1st and 2nd "Mahnung".

• List invoices (list_invoices, read): Outgoing invoices for a period, with status, due date, total and open amount.
• Record payment (record_payment, write, asks first): Record a customer payment on an invoice and lower its open amount.
• Create payment reminder (create_payment_reminder, write): Create the next reminder for an overdue invoice: payment reminder, 1st or 2nd dunning letter.

Working hours

Work and travel time for one or several employees on a project, and the "Zeiten" list by period, person or project.

• List time entries (list_time_entries, read): Booked working hours, travel time and absences, by period, employee or project.
• Create time entry (create_time_entry, write, asks first): Book working time or travel time for one or more employees on a project.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/plancraft-api-mcp-server#tools

Who can see my Plancraft session, and how do I revoke it?

• What we store. Your signed-in Plancraft browser profile, AES-256-GCM encrypted, in Finland. Never your password.
• What your agent gets. The 14 Plancraft tools. The session cookie stays in the Cloud Browser.
• What the session sees. The projects, documents and hours your Plancraft office user can open, and nothing more.
• What no tool touches. Your Plancraft plan, users and API keys, the DATEV export, incoming supplier invoices, the "Plantafel" and Porta's phone calls.
• If Plancraft logs you out. You log in again yourself, in the same Cloud Browser.
• How to cut access. Disable Plancraft for agents, reset the browser, or change your Plancraft password.

Cotlet never sees or stores your password: you type it into Plancraft yourself, and the agent works from the session that sign-in leaves. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

What happens when Plancraft changes?

The tools work through the Plancraft pages you use yourself, so a new screen does not stop your offers and invoices. Cotlet watches the apps it serves and updates the Plancraft server when a page changes.

New Plancraft features become available to the agent. Project statuses are read from your own list under "Status verwalten", so renamed statuses keep working.

The agent sees only what your office user can see. If Plancraft logs you out, one click in the Cotlet console reopens the Cloud Browser so you can log in again.

Approvals, undo and mistakes

1. Find what is overdue. list_invoices reads "Überfällig".
2. Create the reminder. create_payment_reminder files it in the project, unsent.
3. Show you the list. Invoice, customer and open amount.
4. Send on your OK. send_document mails it to the customer.

Action	How to put it right
Offer or reminder created	Still unsent: edit or delete it in the project
Invoice made from an offer	Stays an "Entwurf" with no number until you finish it in Plancraft
Payment recorded	Correct the payment on the invoice in Plancraft
Hours booked	Correct the entry under "Zeiten" before your export
Document sent	Already with your customer: follow up with them directly

3 of the 8 write tools ask first: send_document, record_payment, create_time_entry. By default you confirm each call, and you can switch that off per tool. The other writes only add contacts, projects and drafts that reach no one. The 6 read tools run at once.

MCP call:

{
  "name": "create_offer",
  "arguments": {
    "project_id": "prj_41c9d0",
    "subject": "Malerarbeiten Bad",
    "positions": [
      {
        "title": "Untergrund spachteln",
        "quantity": 85,
        "unit": "m2",
        "unit_price": 6.4
      },
      {
        "title": "Waende streichen",
        "quantity": 85,
        "unit": "m2",
        "unit_price": 7.2
      },
      {
        "title": "Decke streichen",
        "quantity": 24,
        "unit": "m2",
        "unit_price": 8.5
      }
    ]
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/plancraft/projects/prj_41c9d0/offers \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subject":"Malerarbeiten Bad","positions":[{"title":"Untergrund spachteln","quantity":85,"unit":"m2","unit_price":6.4},{"title":"Waende streichen","quantity":85,"unit":"m2","unit_price":7.2},{"title":"Decke streichen","quantity":24,"unit":"m2","unit_price":8.5}]}'

Response:

{
  "document_id": "doc_2e71a8",
  "type": "offer",
  "project": "P-00046",
  "subject": "Malerarbeiten Bad",
  "positions": [
    {
      "title": "Untergrund spachteln",
      "quantity": 85,
      "unit": "m2",
      "unit_price": 6.4,
      "total": 544
    },
    {
      "title": "Waende streichen",
      "quantity": 85,
      "unit": "m2",
      "unit_price": 7.2,
      "total": 612
    },
    {
      "title": "Decke streichen",
      "quantity": 24,
      "unit": "m2",
      "unit_price": 8.5,
      "total": 204
    }
  ],
  "net_total": 1360,
  "vat_total": 258.4,
  "gross_total": 1618.4,
  "currency": "EUR"
}

The example drafts a bathroom offer: 85 m2 of filling at 6.40, 85 m2 of walls at 7.20 and 24 m2 of ceiling at 8.50 make 1,360.00 EUR net, 1,618.40 EUR with 19% VAT. A cron job or n8n flow can make the same call over REST at /api/v1/plancraft with the same key and price, in JSON. Failed calls are free.

How much does the Plancraft MCP server cost?

About $18 a month for a painting business with a crew of three and about ten offers a month, 3,080 credits. Your Plancraft plan stays as it is.

Job	Calls	Credits
New customers and projects	3 × 6	180
Offers drafted from site notes	2 × 10	200
Invoice drafts from accepted offers	2 × 10	200
Offers and invoices sent	1 × 20	200
Crew hours booked, every workday	1 × 20	200
Hours checked before invoicing	2 × 8	160
Bank payments recorded	2 × 12	240
Weekly overdue check	1 × 4	40
Reminders created and sent	2 × 8	160
Cloud Browser, 30 days		1,500
Total	158 calls	3,080

The $29 pack covers a typical month for most owners. A bigger crew or more jobs a month means more calls.

• Free 7-day trial, no card
• 10 credits per successful call, MCP or REST
• 50 credits a day for the Cloud Browser
• Your Plancraft plan applies as it is

Credit packs are one-time purchases, not a subscription. The month above is our own example, not measured customer usage.

Plancraft MCP server: other ways to connect

Option	What it does	Where it stops
Porta, Plancraft's AI	Answers phone calls, records what the customer wants and adds new contacts; 60 call minutes a month free.	Takes calls; it does not write offers, record payments or book hours.
Plancraft API	Reads and creates contacts and projects with a key you make in Plancraft, and sends webhooks.	Not on by default; no offers, invoices, payments or hours.
Make or n8n	Plancraft names both for flows on its API; neither has a Plancraft app.	Only what the API covers, and Plancraft gives no setup support.
Zapier	No Plancraft app in the Zapier directory.	Nothing to connect.
DATEV export, GAEB and DATANORM	Invoices to your tax adviser; material catalogs and bills of quantities in.	Files moved, no work done in the project.
By hand	Open each project, document and list in Plancraft.	One screen at a time, only while you are at the desk.

If your job is keeping contacts and projects in step with another system, the Plancraft API with Make or n8n is the vendor's own route. Only Cotlet lets your agent do the daily Plancraft office work on every screen you use, reading and writing offers, invoices, payments and hours, from ChatGPT, Claude or any MCP client, with no Plancraft API key and on your current plan.

Who runs Cotlet

Cotlet belongs to Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), in business since 2019. Its founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Plancraft tools go to contact@cotlet.dev.

Plancraft MCP server: questions

How do I get access?

Sign up free at https://cotlet.dev/signup?app=plancraft, turn on Plancraft under Integrations in the console and log in at https://plancraft.com/de-de/login in your Cloud Browser. Then connect your AI agent and ask it for this month's overdue invoices. The trial needs no card.

Which plancraft account does my agent need?

An Office account. Plancraft says documents and project planning are done in the browser application, and mobile users only get the mobile app. You sign in once with your email and password at plancraft.com/de-de/login, in your own Cloud Browser.

What if my plancraft plan lacks a feature?

The agent can only do what your plan allows. Plancraft sells Business, Pro and Premium, and Pro adds things such as the GAEB interface and post-calculation. After the 7-day trial, an account without a subscription drops to a free plan with fewer features, and your data stays.

Do I talk to the agent in German?

As you like. Plancraft's screens stay in German and the agent works on them as they are; you can ask in English or German, and offers keep the position texts you give.

Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 14 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.

Is Cotlet affiliated with Plancraft?

No. Cotlet is independent and not affiliated with Plancraft GmbH.

---

Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.