
freispace MCP Server
โ 1from freispace
Query freispace for resource scheduling and project planning data
freispace MCP Server
A Model Context Protocol (MCP) server that provides analytics and insights for the scheduling software freispace. This server enables AI assistants (e.g. Copilot, Gemini) to query data within freispace, such as project statistics and planning related information.
Overview
The freispace MCP Server connects any LLM with tooling capabilities to freispace to query analytical data.
Media teams using freispace can leverage the MCP server to make planning data available to the entire company using the company-wide AI (e.g. Copilot), without users having to be on freispace or even know about freispace, as well as help post-production teams make data-driven decisions while scheduling and planning.
Our MCP Server always respects user permissions, ensuring that the LLM will only be able to access data on a per-user level, ensuring data safety.
Example queries might be "Who worked with Person X in the past" or "How many vacation days do I have left?"
Available Tools
All lookups are name-based. Partial names match; the first match is used.
get_current_user
Who the calling user is: name, email and linked staff record. No arguments. Use it to resolve "I"/"me"/"my" to a staff name.
"Who am I logged in as?"
get_staffs
List staff members with name, title and staff number.
status(optional):active(default),inactive,all
"List all staff members" ยท "Who are the developers in the company?"
find_resources
Search rooms/studios (suites), equipment/licenses (resources) and staff by name in one call, grouped by type.
search(optional): name or partial name; omit to list everythingstaff(optional):internalorexternalsite(optional): only suites at matching sitesstatus(optional):active(default),inactive,all
"Find Sammy" ยท "List external freelancers"
get_availability
Check when staff, suites or resources are free in a date window (default 14 days, max 92), considering bookings, public holidays and staff absences/work times.
type(required):staff,resource,suiteorsitesearch,staff,site,status(optional): entity selection as infind_resourcesfrom,to,days,weeks(optional): the date windowduration+duration_unit(optional): required free length (minutes,hoursordays)
"Is a studio free next Tuesday for 3 hours?" ยท "Who has 2 fully-free days in the next two weeks?"
get_my_schedule
The calling user's own bookings in a date window (default: next 7 days).
from,to,days,weeks(optional): the date window
"What's on my schedule this week?"
get_my_tasks
Tasks assigned to the calling user, with due date, priority and reference.
include_done(optional): also include completed tasks
"What are my open tasks?"
get_open_tasks
All open tasks of the team, with assignees.
reference(optional):project,bookingoruser
"Which project tasks are still open?"
get_staff_projects
List the projects a staff member is booked on, with date range and duration.
staff_name(required)
"What projects is Karl booked on?"
get_staff_collaborators
Show who a staff member has worked with, based on shared bookings.
staff_name(required)
"Who has Alexander worked with?"
get_staff_next_holiday
Get a staff member's next upcoming holiday (start, end, length, comment).
staff_name(optional; omit for the calling user)
"When is my next holiday?" ยท "When is Hendrikje on holiday?"
get_staff_holiday_quota
Get a staff member's holiday quota for one year: total, taken and remaining days.
staff_name(optional; omit for the calling user)year(optional; defaults to the current year)
"How many vacation days do I have left?"
get_project_stats
Booking statistics for one project: past vs upcoming bookings with per-status breakdown.
project_name(required)
"Show booking stats for Project Alpha"
get_project_team
List the staff members who worked on a project, with their number of bookings on it.
project_name(required)
"Who worked on the website redesign?"
get_project_tasks
Task status of one project: all tasks on the project and its bookings, with an open/done/overdue summary.
project_name(required)
"Are there open tasks on the documentary project?"
get_invoices
List invoices with filters and per-currency totals; paginated. Status buckets: draft, open, overdue, paid, partially-paid, canceled, locked.
search(optional): matches number, order number, subject, recipient addressstatus,number,date_min/date_max,due_date_min/due_date_max,sum_min/sum_max,outstanding_min/outstanding_max,sort,order,page,per_page(optional)
"Which invoices are overdue?" ยท "Open invoices for Acme"
get_offers
List offers (quotes) with filters and per-currency net totals; paginated. Status buckets: draft, locked, open, accepted, declined.
search,status,number,date_min/date_max,sum_min/sum_max,sort,order,page,per_page(optional)
"Show declined offers from this year"
get_orders
List orders (jobs) with their connected offers and invoices inline; paginated.
search(optional): matches order number and namestatus,number,date_min/date_max,sort,order,page,per_page(optional)
"What was quoted and billed on order 2026-014?"
search_docs
Search the freispace documentation and return the most relevant excerpts.
query(required)limit(optional): max excerpts, default 5
"How do I set up shift planning in freispace?"
Error Handling
Errors are returned to the calling model as short, actionable messages (e.g. Not found (404): Staff member with name 'X' not found. Call get_staffs to list valid staff names.). Diagnostics are logged to stderr; stdout carries only the MCP protocol.
โ ๏ธ Beta Notice
Our freispace MCP server is currently in beta. All features are free during this period. We appreciate your feedback and patience as we continue to improve the platform.
Support
For support and questions:
- Documentation: freispace documentation
- Issues: GitHub Issues
- Contact: freispace Support
Prerequisites
- freispace Flagship account
- Valid MCP API key for freispace
- During
beta, contact your freispace support team to obtain an MCP API key
- During
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
License
MIT License - see LICENSE file for details.