FlowyTeam MCP Server Documentation

Connect Claude, ChatGPT, n8n, or any AI agent to your FlowyTeam workspace. No middleware. No custom code. Just plug in and start automating.

Open Standard

What is an MCP Server?

MCP (Model Context Protocol) is an open standard that lets AI agents talk directly to your tools. FlowyTeam ships as a native MCP Server — meaning your AI can read and write real data inside your workspace without any intermediary layer.

Capabilities

What Your AI Can Do

Tasks

Manage tasks: list, create, update, delete, mark complete. Filter by status, priority, project, assignee, due date.

GET POST PUT DELETE
Projects

Manage projects and their sub-resources (milestones, members, categories, files). Set resource=project (default), milestone, member, category, or file. All lookups are name-based — no IDs needed. Admins have full access. Members can view/update their own projects, and perform full CRUD on milestones, members, and files.

GET POST PUT DELETE
Task Category

Manage task categories: list, create, update, delete. Lookup by ID or category name.

GET POST PUT DELETE
Leave

Manage employee leave requests: list, create, approve, reject, cancel. Filter by status, employee, date range.

GET POST PUT DELETE
Leave Type

Manage leave types (annual, sick, etc.): list, create, update, delete. Admin-only for write operations.

GET POST PUT DELETE
Attendance

Manage attendance: clock-in, clock-out, list records. Filter by employee, date, month, year.

GET POST PUT
Employees

Manage employees: list, show full profile, create, update (profile/department/designation/status/skills), deactivate/delete. Always resolve by name or email — never require an ID from the user.

GET POST PUT DELETE
Department

Manage departments/teams: list, show details with members, create, update, delete, add/remove members. Always resolve by name — never require an ID from the user.

GET POST PUT DELETE
Designation

Manage job designations/positions: list (with member counts), create, update, delete. Always resolve by name — never require an ID from the user.

GET POST PUT DELETE
Clients

Manage clients: list, create, update, delete. Filter by name, company.

GET POST PUT DELETE
Tickets

Manage support tickets and their conversation replies. Supports full CRUD (list, create, update, delete), reply/conversation management (resource=reply), ticket statistics (action=stats), and close/reopen actions. Name-based lookups for agent, requester, type, and channel. Admins and privileged members have full access. Regular members can manage their own tickets (create, view, reply, close, reopen).

GET POST PUT DELETE
Ticket Type

Manage ticket types/classifications: list, create, update, delete. Lookup by name or ID.

GET POST PUT DELETE
Ticket Channel

Manage ticket channels (e.g. email, phone, chat): list, create, update, delete. Requires the tickets module.

GET POST PUT DELETE
Ticket Agent

List ticket agents and their assigned groups.

GET
Objectives

Manage OKR objectives: list, create, update, delete. Filter by cycle, type (company/team/personal), status.

GET POST PUT DELETE
Key Result

Manage OKR key results: list, create, update, delete, update progress. Link to objectives.

GET POST PUT DELETE
Indicators

Manage KPI indicators: list, create, update, delete. Filter by category, employee. Lookup by title or ID.

GET POST PUT DELETE
Indicator Category

Manage KPI indicator categories/types: list, create, update, delete. Lookup by name or ID.

GET POST PUT DELETE
Indicator Record

Manage KPI indicator records (actual values per period): list, add, delete. Lookup by indicator_id + period_key.

GET POST DELETE
Performance Cycle

Manage OKR performance cycles: list, create, update, delete. Lookup by name or ID.

GET POST PUT DELETE
Holiday

Manage company holidays: list, create, update, delete. Filter by year, upcoming/past. Lookup by ID or holiday name.

GET POST PUT DELETE
Leads

Manage sales leads: list, create, update, delete. Filter by status, agent, date range.

GET POST PUT DELETE
Invoices

Manage client invoices: list, create, update status, delete. Filter by client, status, date range.

GET POST PUT DELETE
Estimates

Manage client estimates/quotes: list, create, update, delete. Filter by client, status, date.

GET POST PUT DELETE
Events

Manage company events/calendar: list, create, update, delete. Filter by month, year, date range.

GET POST PUT DELETE
Expenses

Manage expenses and claims: list, create, update status (approve/reject), delete. Filter by employee, category, status, date range.

GET POST PUT DELETE
Expense Category

Manage expense categories: list, create, update, delete. Admin-only for write operations.

GET POST PUT DELETE
Notices

Manage notice board: list, create, update, delete. Filter by date range or audience (all/employee/client).

GET POST PUT DELETE
Contracts

Manage client contracts: list, create, update, delete. Filter by client, status, date range.

GET POST PUT DELETE
Timelogs

Manage project/task time logs: list, create (start timer), update (stop timer/edit), delete. Filter by project, employee, date.

GET POST PUT DELETE
Quick Setup

How to Connect

Three steps and your AI agent is live inside FlowyTeam.

1

Generate your API Key

Go to Settings → API & Integrations in your FlowyTeam dashboard and create a new API key with the scopes you need.

2

Add the MCP config

Paste the JSON snippet below into your AI agent's MCP configuration file (e.g. Claude Desktop, Cursor, or n8n).

{
  "mcpServers": {
    "flowyteam": {
      "type": "http",
      "url": "https://flowyteam.com/api/v2/mcp/rpc",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
3

Start chatting

Reload your AI client. FlowyTeam tools now appear in the tool list — just ask your AI to use them.

Integrations

Compatible AI Clients

FlowyTeam's MCP Server works with any client that supports the Model Context Protocol.

FlowyTeam
Claude

Anthropic

FlowyTeam
ChatGPT

OpenAI

FlowyTeam
n8n

Workflow Automation

FlowyTeam
Cursor

AI Code Editor

Ready to connect your AI?

Create your free FlowyTeam account and have your first AI agent running in under five minutes.