Manus MCP Server

Connects manus.im with Google Drive over Google Cloud

README.md

manus-mcp

MCP server on Fly.io that connects manus.im with Google Drive over Google Cloud.

What it does

  1. OAuth: Users hit /auth/google → redirect to Google → callback at /auth/google/callback → token stored on the server (in a Fly volume).
  2. MCP tools: After one-time auth, Cursor/other MCP clients can call:
    • drive_list_files(folder_id, page_size) – list files in a Drive folder
    • drive_read_file(file_id) – download file content (text or base64)
    • drive_upload_file(name, content, folder_id, mime_type) – upload a file

So manus.im (or any MCP client) can use this server as a bridge to Google Drive.


1. Google Cloud setup

  1. Go to Google Cloud Console and create or select a project.
  2. Enable the Drive API: APIs & Services → Library → search “Google Drive API” → Enable.
  3. OAuth consent screen: APIs & Services → OAuth consent screen → External (or Internal) → fill app name (e.g. “manus-mcp”), save.
  4. Credentials: APIs & Services → Credentials → Create credentials → OAuth client ID.
    • Application type: Web application
    • Name: e.g. manus-mcp-fly
    • Authorized redirect URIs: add exactly:
      • https://mcp-iwh3fa.fly.dev/auth/google/callback
    • Create → copy Client ID and Client secret.

2. Fly.io setup

  1. Secrets (replace with your values):

    fly secrets set GOOGLE_CLIENT_ID="your-client-id.apps.googleusercontent.com"
    fly secrets set GOOGLE_CLIENT_SECRET="your-client-secret"
    

    Optional (only if you use another URL):

    fly secrets set BASE_URL="https://mcp-iwh3fa.fly.dev"
    
  2. Volume for token persistence (one-time, same region as app):

    fly volumes create manus_mcp_data --region iad --size 1
    
  3. Deploy:

    fly deploy
    

3. First-time Google Drive connection

  1. Open: https://mcp-iwh3fa.fly.dev/auth/google
  2. Sign in with the Google account whose Drive you want to use.
  3. Approve the requested Drive access.
  4. You’ll be redirected back with “Connected. You can close this tab…”
  5. The server stores the refresh token in /data (Fly volume). MCP tools can now call the Drive API.

4. Connecting manus.im (or any MCP client)

Point your MCP client at this server’s HTTP transport.

  • URL: https://mcp-iwh3fa.fly.dev
  • Transport: HTTP (FastMCP). If your client expects an MCP endpoint path, check its docs (e.g. /mcp or root).

Example for a Cursor/IDE MCP config (format depends on your client):

{
  "mcpServers": {
    "manus-drive": {
      "url": "https://mcp-iwh3fa.fly.dev"
    }
  }
}

After that, tools drive_list_files, drive_read_file, and drive_upload_file are available to the client (e.g. manus.im or Cursor).


Endpoints

Path Method Description
/ GET 200 OK (for Fly checks)
/health GET JSON {"status":"healthy"}
/auth/google GET Redirect to Google OAuth
/auth/google/callback GET OAuth callback; saves token

Local development

cd mcp
pip install -r requirements.txt
# No volume; token is stored in ./google_drive_token.json
export GOOGLE_CLIENT_ID="..."
export GOOGLE_CLIENT_SECRET="..."
export BASE_URL="http://localhost:8000"   # or use ngrok and set BASE_URL to ngrok URL for callback
python server.py

Then open http://localhost:8000/auth/google (or your ngrok URL) to complete OAuth. Call the MCP tools via your client pointing at http://localhost:8000.


Summary

  • manus.imFly.io (mcp-iwh3fa.fly.dev)Google Drive via Google Cloud (OAuth + Drive API).
  • One-time auth in the browser; tokens stored on Fly in a volume.
  • MCP tools: list, read, upload files on the authenticated Drive.

Tools 3

drive_list_filesList files in a Drive folder
drive_read_fileDownload file content (text or base64)
drive_upload_fileUpload a file to Google Drive

Environment Variables

GOOGLE_CLIENT_IDrequiredGoogle Cloud OAuth client ID
GOOGLE_CLIENT_SECRETrequiredGoogle Cloud OAuth client secret
BASE_URLThe base URL of the server for OAuth callbacks

Try it

List the files in my root Google Drive folder.
Read the content of the file with ID 12345.
Upload a new text file named 'notes.txt' with the content 'Hello World' to my Drive.
Find all files in the folder with ID 67890.

Frequently Asked Questions

What are the key features of Manus MCP?

OAuth authentication for secure Google Drive access. List files within specific Google Drive folders. Read text or base64 content from Drive files. Upload new files to Google Drive with specified MIME types. Token persistence using Fly.io volumes.

What can I use Manus MCP for?

Integrating Google Drive file access directly into Cursor or manus.im. Automating file uploads to specific Drive folders via AI agents. Retrieving and summarizing document content from Drive using an MCP-compatible IDE. Managing Drive file organization through natural language commands.

How do I install Manus MCP?

Install Manus MCP by running: fly deploy

What MCP clients work with Manus MCP?

Manus MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Manus MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare