read_submissionLABSCO SUMMARY
The classification goes back into the form.
Reading submissions is common; writing the result back as a column, created on the fly, is what makes this a loop rather than a report. Paired with fetch_file extracting PDF text, a batch of applications can be read, judged and tagged without anything leaving the form.
What it is
A hosted MCP server at https://app.formester.com/mcp that gives an assistant access to Formester form submissions. It reads responses, filters across a form, writes values back as custom fields, and returns file attachments in a form a model can actually read.
What you get
- read_submission — one submission by UUID, including custom fields written by earlier runs;
include_files: trueadds attachment metadata - query_submissions — search across a form with filters for date range, starred, spam and a named custom field and value; paginated, 1–100 per page
- update_submission — write values back as custom fields, creating the column automatically. Types include
shorttext,longtext,number,date,time,radio,multiple-checkboxandcheckbox - fetch_file — download an attachment for processing. Images come back as base64 for vision models, PDFs as extracted text by default, text files as plain text. File size limit 10 MB
- Scopes are per tool: reads need
submission:read, writes needsubmission:write
Requirements
A Formester account. Interactive clients — Claude, Cursor, VS Code — use OAuth: add the URL and approve in the browser, no token to manage. Scripts and clients without OAuth use an API token created under API in the Formester sidebar, sent as Authorization: Bearer, and scoped when you create it to View Submissions, Update Submissions and optionally View Forms, and to specific forms if you do not want the whole organisation.
Setup effort
One command plus a key — claude mcp add --transport http formester https://app.formester.com/mcp, then supply credentials
USE CASES
01
Triaging a contact form
Pull the recent submissions, classify each one, and save the category back as a custom field.
02
Reviewing a job application
Read the submission with files included, extract the CV, and write the evaluation back.
03
Finding the urgent ones in a backlog
Query the last batch, flag the billing and access problems, and set a priority field.
04
Summarising a single ticket
Read it by ID and write a one-sentence summary back onto it.
4 tools
Listed in project docs. Your client may show a different list.
query_submissionsupdate_submissionfetch_fileBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
A client that can reach a remote MCP server over HTTP
INSTALLATION
Connect your client
Server setup
claude mcp add
TERMINAL
claude mcp add --transport http formester https://app.formester.com/mcpHosted endpoint
ENDPOINT URL
https://app.formester.com/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"formester": {
"command": "npx",
"args": [
"mcp-remote",
"https://app.formester.com/mcp",
"--header",
"Authorization: Bearer <YOUR_TOKEN>"
]
}
}
}ChatGPT
ChatGPT → Apps → Search for "Formester" → Connect. ChatGPT handles OAuth automatically.
VS Code
VS CODE · JSON
{
"servers": {
"formester": {
"type": "http",
"url": "https://app.formester.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}Cursor
CURSOR · JSON
{
"mcpServers": {
"formester": {
"url": "https://app.formester.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add --transport http formester https://app.formester.com/mcp --header "Authorization: Bearer <YOUR_TOKEN>"Windsurf
WINDSURF · JSON
{
"mcpServers": {
"formester": {
"type": "streamable-http",
"serverUrl": "https://app.formester.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}
