---
description: Structured sample data, traceable changes and small interfaces instead of opaque exports.
url: https://www.schmalzl.tirol/en/blog/2024-10-17-filemaker-json-versionen-dokumentation
lang: en
date: 2024-10-17
deutsch: /blog/2024-10-17-filemaker-json-versionen-dokumentation.md
---

# FileMaker and JSON: keeping data and changes readable

_17 October 2024 · Archive date_

When an application grows, its screen is not the only thing that matters. Data structures and changes should stay understandable too. Otherwise you later know that something is different, but not what has changed.

A small invented book file is enough to show the connection: a title has a text value, a volume number has a number value, and a list has several entries. A clearly described structure stops everyone involved from reading something different into the same fields.

## Data needs a readable form

JSON describes objects and lists with explicitly named values. That helps when handing data between tools. For an exercise, field names, expected data types and how to handle empty values should be fixed beforehand.

If you use an extra shorthand notation, you have to check that converting it produces the same structure. Fewer characters are only an advantage if the meaning is kept.

For comparing structures, FileMaker offers an XML export. [Claris explains "Save a Copy as XML"](https://help.claris.com/en/pro-help/content/save-a-copy-as-xml.html) and points out that comparisons need the same export version. For a public demo, a small self-made file is enough; company data or scripts are not needed.

## Interfaces do not change who is responsible

An AI connection via MCP can make tools and data access available. [The MCP architecture describes the roles of host application, client and server](https://modelcontextprotocol.io/docs/learn/architecture). Which functions a specific FileMaker connection actually offers is a separate product question.

To start with, a read-only query of the invented book list would be easy to follow. After that you can check whether fields are understood correctly and changes are described cleanly. The readable structure stays just as important as a convincingly worded answer.

## Original finds

These links were the starting point for this post. The assessment in the text is my own; the linked posts are not my own tests.

- [Opening up FileMaker files with fmptools](<https://github.com/evanmiller/fmptools>)
- [DDRparser: following FileMaker structures and scripts](<https://www.facebook.com/share/p/17AZMiZSab/>)
- [DDRparser: following FileMaker structures and scripts](<https://www.linkedin.com/pulse/from-codex-text-filemaker-script-workspace-few-seconds-hornnes-ww7ne>)
- [FileMaker performance as a learning topic](<https://www.linkedin.com/posts/claris-international-inc_make-your-claris-filemaker-apps-faster-activity-7355999182748372993-jjCx>)
- [Tracking FileMaker changes with XML and FMUpgradeTool](<https://youtu.be/tMX-7Gleg0Y>)
- [Claude Code documentation as a starting point](<https://www.linkedin.com/posts/crisippolite_excellent-claude-code-best-practices-document-activity-7382416443881156608-iMy3>)
- [Moving AI scripts between a coding editor and FileMaker](<https://www.facebook.com/share/p/18F9hZMHrD/>)
- [Moving AI scripts between a coding editor and FileMaker](<https://www.facebook.com/share/p/1j5sBPmFWP/>)
- [fmJAML: working with JSON more readably](<https://github.com/fmIDE/fmJAML>)
- [Preparing FileMaker solutions for agent work](<https://www.linkedin.com/pulse/get-your-house-order-agentic-filemaker-coming-most-solutions-hague-8bwcc>)
- [Claris Docs Skills for targeted help articles](<https://www.linkedin.com/posts/ask-an-ai-coding-agent-a-filemaker-question-share-7475181752890667008-nhlu/>)
- [FileMaker scripts and version history](<https://www.linkedin.com/posts/ronny-schrader-a2414418b_filemaker-git-ai2fm-share-7489237270315610112-0T1R/>)
- [Calling ChatGPT from FileMaker](<https://www.facebook.com/share/p/46bFzYdacBu5TZSd/>)
- [Talk on connecting a FileMaker solution to Claude via an MCP server.](<https://www.linkedin.com/posts/marcel-more_fmdisc-2025-08-08-activity-7360960901451067392-vMsN>)
- [FM Analyzer analyses uploaded DDR XML files; do not upload your own company files.](<https://www.facebook.com/share/p/17ngac1XZ8/>)
- [ZippyCue analyses DDR files locally on macOS and exports scripts, functions and structure information.](<https://www.facebook.com/share/p/1AziqHUFym/>)
- [Overview of AI development with MBS: local models, CoreML, Windows ML, OCR, Vision, Python and CURL.](<https://www.facebook.com/share/p/18ZVzDBV5H/>)
- [Podcast about ProofKit MCP and AI-assisted FileMaker development.](<https://www.linkedin.com/posts/ernestkoe_the-context-podcast-proofkit-mcp-share-7452895763539320833-qOUI>)
- [The author uses ProofKit to demonstrate an AI-assisted FileMaker app for farming workflows.](<https://www.linkedin.com/posts/adrianrvalenzuela_filemaker-claris-proofkit-ugcPost-7468401497295200259-zXqK/>)
- [FMS Detective with log analysis, DDR import, an AI assistant and additional iOS management.](<https://www.linkedin.com/posts/samuelrulonmiller_fms-detective-share-7468717685061693440-WYIR/>)

> **About the date:** This post was written on 11 October 2026. The archive date is the date of the earliest related find in the collection, not of a publication at that time. Technical assessments and sources added later refer to the time of writing.