Fruitask MCP Integration

Connect Fruitask to AI assistants like Claude Desktop, Claude Code, Cursor, and VS Code Copilot using the open Model Context Protocol (MCP). Let your AI read and act on your workspaces, tables, notes, folders, and calendars — securely, with your own API key.

Create an API key Developer API docs

What is MCP?

The Model Context Protocol is an open standard that lets AI applications connect to external tools and data sources. The Fruitask MCP server exposes your account's data as a set of tools the AI can call — so you can ask things like “summarize my open tasks”, “add a note for tomorrow's standup”, or “create a calendar event next Monday”, and the assistant executes them through Fruitask.

Server endpoint

The Fruitask MCP server speaks over SSE (Server-Sent Events):

https://backend.fruitask.com/api/mcp/sse

Discovery (server info + tool list): https://backend.fruitask.com/api/mcp

Authentication

Every request is authenticated with a Fruitask API key sent as a Bearer token. Create one in Account → API & Integrations. Each key has scoped permissions (read / write / delete) and an optional expiry — the MCP tools you can call are gated by your key's scopes.

Treat API keys like passwords. They grant access to your Fruitask data. Use a read-only key when the assistant only needs to look things up, and revoke keys you no longer use.

Quick setup

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "fruitask": {
      "url": "https://backend.fruitask.com/api/mcp/sse",
      "headers": {
        "Authorization": "Bearer fk_YOUR_API_KEY_HERE"
      }
    }
  }
}

Generic MCP client (SSE)

Any MCP-compatible client (Cursor, VS Code, custom agents) can connect with:

Endpoint (SSE): https://backend.fruitask.com/api/mcp/sse
Header:         Authorization: Bearer fk_YOUR_API_KEY_HERE

Replace fk_YOUR_API_KEY_HERE with a key from your account. Restart the client after adding the server.

Available tools

18 tools

readLook up and search your data

`list_workspaces`	List all workspaces you can access.
`get_workspace`	Get a workspace with its tables.
`query_table`	Query rows from a table.
`get_row`	Get a specific row by id.
`list_notes`	List all notes.
`get_note`	Get a note's content.
`search`	Search across workspaces and notes.
`list_folders`	List all folders.
`list_calendars`	List calendars you own or collaborate on.
`get_calendar_events`	Get events from a calendar (filter by date range / category).

writeCreate and update content

`create_row`	Create a new row in a table.
`update_cell`	Update a single cell value.
`create_note`	Create a new note.
`add_block`	Append a content block to a note.
`create_calendar_event`	Create a new calendar event.
`update_calendar_event`	Update an existing calendar event.

deleteRemove content

`delete_row`	Delete a row from a table.
`delete_calendar_event`	Delete a calendar event.

Permissions & scopes

Tools are grouped by the permission they require. Your API key's scopes decide which tools the assistant can use:

read list and fetch workspaces, tables, rows, notes, folders, calendars and events; search.
write create rows/notes/blocks/events and update cells and events.
delete remove rows and calendar events.

The most restrictive rule always wins, and workspace/table permissions still apply on top — the MCP server never bypasses your existing access controls.

Compatible clients

Claude DesktopClaude CodeCursorVS Code (Copilot/MCP)WindsurfCustom agents (SDK)

Any client that supports MCP over SSE with a Bearer token will work.

Fruitask logo

Adding Fruitask as a connector or integration on another platform? Download the official Fruitask MCP icon to use as the connection's logo.

Fruitask MCP icon

PNG · transparent background · square

Download logo

Or paste the image URL directly where the platform asks for a logo URL:

https://fruitask.com/brand-logo/fruitask-mcp.png

Ready to connect your AI?

Create a scoped API key and point your MCP client at the endpoint above.

Create an API key Read the API docs