Home Pricing Features Docs Tutorials Blog Changelog Start free trial

AI Connection

What It Is

You can connect your own AI app, such as Claude Desktop or Claude Code, to FilmBase. Your AI app can then answer questions about the project that is open, and change it if you allow that. Ask it how many shoot days the schedule has, which scenes a prop appears in, or what the camera department costs, and it reads the answer from your project.

FilmBase runs no AI for this and needs no account or key from an AI company. It gives your AI app a set of tools, and your AI app decides when to use them. Each tool does the same thing as the matching action on a FilmBase page, so totals, schedule links and re-pricing work the same way as when you make the change yourself.

The AI connection is off until you turn it on. It works only while FilmBase is open with a project, and only with an active plan. The free trial counts.

Turning It On

  1. Open Settings and choose AI connection, under the global settings.
  2. Turn on AI connection. The status reads On. Waiting for your AI app to connect.
  3. Copy the setup for your AI app from Set up your AI app and add it to the AI app (see below).
  4. Restart your AI app, open a project in FilmBase, and ask your AI app about it. The status changes to Connected, with the name of the AI app.

The connection works on this computer only and needs no internet connection between your AI app and FilmBase. If FilmBase is closed, or the connection is off, your AI app is told to ask you to open FilmBase, open a project and turn on Settings > AI connection.

Connecting Claude Desktop

  1. In FilmBase, in Settings > AI connection, click Copy beside Claude Desktop settings.
  2. In Claude Desktop, open Settings, then Developer, then Edit Config.
  3. Add the copied block to the file and save it. If the file already has an mcpServers section, add the filmbase entry inside it.
  4. Restart Claude Desktop.

The block names FilmBase on your computer as the program to start, with the --mcp switch. Your AI app starts it when it needs it, and it talks only to the FilmBase that is open on the same computer.

Other AI Apps

For AI apps that ask for a command to run, such as Claude Code, copy the Command shown in Settings > AI connection. It is the path to FilmBase on your computer followed by --mcp. Copy it from Settings rather than typing it, because the path differs between computers and between the Mac download and the Microsoft Store install.

The Three Switches

  • AI connection: lets an AI app on this computer read the project that is open. Off by default.
  • Allow changes: lets the connected AI app change the open project, including adding and deleting. Off by default, and only available while AI connection is on.
  • Include bank and ID details: lets the AI app read and change contacts' bank details and tax and registration numbers. Off by default, and only available while AI connection is on.

Turning AI connection off turns the other two off as well, so turning it back on later never brings back changes or bank and ID details by itself. These are global settings: they apply to every project you open on this computer.

What Your AI App Can Read

With AI connection on, your AI app can read the project that is open:

  • Script: scenes, scene text, characters, shots, and the breakdown tags and elements.
  • Schedule: blocks and their calendar, stripboards, shoot days, Day out of Days, conflicts, locations, transport and vehicles.
  • Budget: totals, categories, lines, fringes, globals, currencies, expenses, income and cashflow. Totals are FilmBase's own figures, not sums your AI app works out.
  • Cast and crew: names, departments, roles, characters, contact details, dietary requirements, deals and rate cards. Bank details and tax and registration numbers are left out unless Include bank and ID details is on.
  • Call sheets and reports: the call sheet for each shoot day, the reports and the project's settings.

What It Can Change

Nothing, unless you turn on Allow changes. With it on, your AI app can:

  • Script: edit script text and scene details, add shots, tag scenes, and promote tags to elements.
  • Schedule: build and change the schedule: blocks, shoot days and day types, strips, the optimizer, and cast and crew days.
  • Budget: build and change the budget: categories, lines, fringes, globals, currencies, templates, expenses and income.
  • Cast and crew: add and change contacts, their deals, departments, roles and rate cards.
  • Call sheets and files: fill in call sheets, locations, transport and vehicles, and save a budget, script or report file to the project's Exports folder.

Your AI app can delete things when you ask it to, and a delete it makes can be undone like any other change. Where FilmBase would ask you a question, such as whether to convert values when a currency changes, your AI app gives the answer, so ask it to check with you before it makes that kind of change.

Out of Reach

Your AI app cannot mark a call sheet final, import a script, or reach your account, plan, project password, team sharing, backups, app settings or other projects. In a read-only project it cannot change anything.

Changes also need Record changes to be on in Settings > General, because the change history is what makes them undoable. With it off, your AI app is told to ask you to turn it on.

Undoing AI Changes

Each change your AI app makes is kept as one step. A long job, such as building a budget from the schedule, is kept as one step too. You can undo the whole step:

  • In Settings > AI connection, under Changes made by your AI app, click Undo beside the latest change.
  • In a project shared with your team, open Team > History (for members who can manage roles). Changes made by your AI app are marked AI, and Undo AI change takes back the whole step.
  • Or ask your AI app to undo its last change.

If you or a teammate edited the same item after the AI change, that item is left as it is, and FilmBase lists what it left. Undo restores records in the project, not files on disk such as photos or exported files.

Privacy

FilmBase itself sends nothing over the AI connection. It answers your AI app on this computer, and your AI app sends what it reads from your project to that AI's provider. You choose the AI app and its provider, and their terms apply to what your AI app reads.

Bank details and tax and registration numbers stay out of everything your AI app reads unless you turn on Include bank and ID details. With it on, your AI app sends those details to your AI provider when it reads a contact. Turn AI connection off at any time to stop it.

The AI script breakdown that runs on your computer is a separate feature. Scripts it analyzes are never sent anywhere. See Script Breakdown.

Your Plan

The AI connection needs an active FilmBase plan, and the free trial counts. If your plan ends, your AI app can no longer read or change the project and is told why, and the switches in Settings cannot be used until you choose a plan. Without internet the connection keeps working for as long as FilmBase itself does, up to the Works offline until date on the Subscription page. See Subscription & Billing.