Fusebase

You can run Fusebase MCP Server to let AI assistants manage your Fusebase workspaces, including pages, folders, tasks, tags, files, and members, using prebuilt MCP tools that connect to your Fusebase account through secured sessions.

How to use

You connect an MCP client to the Fusebase MCP Server and start using the 46 available tools to read, modify, and manage your Fusebase data. Begin with the core tools to list workspaces, pages, folders, tags, and members, then enable extended tools for advanced operations like content mutations, file access, and organization insights as needed. The server handles automatic authentication retries and encrypts session cookies to keep your credentials secure.

How to install

Prerequisites: You need Node.js 18 or newer and an active Fusebase account.

Step 1: Install the MCP server.

# Option A — Install from GitHub (recommended)
npm install -g github:ryan-haver/fusebase-mcp

# Option B — Clone and build manually
git clone https://github.com/ryan-haver/fusebase-mcp.git
cd fusebase-mcp
npm install

Configuration and starting the server

Step 2: Configure your environment by copying the example file and providing your Fusebase details.

cp .env.example .env

FUSEBASE_HOST=yourorg.nimbusweb.me     # Your org's Fusebase hostname
FUSEBASE_ORG_ID=your_org_id            # Found in Fusebase URL or API responses

Step 3: Authenticate to capture session cookies securely.

npx tsx scripts/auth.ts

Headless re-authentication is supported after the first login.

npx tsx scripts/auth.ts --headless

Step 4: Connect the MCP client to Fusebase by using the following runtime command structure.

node /path/to/fusebase-mcp/dist/index.js

Configuration for MCP clients

Use the following snippets in your MCP client configuration to point to the local MCP server. The examples assume you installed the server locally and that you will replace the path with your actual location.

{
  "fusebase": {
    "command": "node",
    "args": ["/path/to/fusebase-mcp/dist/index.js"],
    "env": {
      "FUSEBASE_HOST": "yourorg.nimbusweb.me",
      "FUSEBASE_ORG_ID": "your_org_id"
    }
  }
}

Security and maintenance

Cookies are stored encrypted at rest using AES-256-GCM. Expired sessions are refreshed automatically, and credentials stay out of version control if you follow the recommended environment file setup.

Project structure and roadmap

The server exposes a core set of 18 tools by default and 28 extended tools on demand, with built-in update checks from GitHub and comprehensive API logging for debugging.

Troubleshooting and tips

If you encounter authentication issues, use the refresh_auth tool to renew cookies. Ensure your environment variables are set exactly as shown and that the dist/index.js path reflects your installation location.

Notes on tools and capabilities

Core tools provide day-to-day access to content, membership, and task management, while extended tools unlock administrative features, analytics, portals, databases, and more when you enable them.

License

MIT license.

Available tools

set_tool_tier

Enable extended tools or check current tool tier

check_version

Check for server updates from GitHub

refresh_auth

Refresh session cookies via Playwright

list_workspaces

List all workspaces

list_pages

List pages with optional folder and pagination filtering

get_page

Get metadata for a page

get_page_content

Get raw HTML content for a page

get_recent_pages

List recently accessed pages

create_page

Create a new blank page

list_folders

List folders for a workspace

get_tags

Retrieve tags for a workspace or page

update_page_tags

Set or update tags on a page

get_members

List workspace or org members

search_tasks

Search tasks by workspace or page

list_task_lists

List task boards and tasks

create_task

Create a task in a task list

delete_page

Delete a page

update_page_content

Update the content of a page

get_page_attachments

List attachments for a page

list_files

List files in a workspace or folder

get_file_count

Get count of files in a workspace or folder

get_labels

Retrieve labels for notes or pages

get_note_tags

Retrieve tags for notes

get_activity_stream

Get activity stream for a workspace

get_comment_threads

Get comment threads for pages or notes

get_task_description

Get detailed description for a task

get_task_count

Get count of tasks in lists or boards

get_task_usage

Get usage statistics for tasks