Cindyloo Dropbox Mcp Server

ai.smitheryPublished by smithery.aiOfficial publisherv1.15.0Updated Oct 24, 2026

Search, browse, and read your Dropbox files. Find documents by name or content, list folders, and…

The publisher's own server: 222wcnm Bilistalkermcp

VerifiedStreamable HTTPWeb executableFiles & StorageKnowledge & Memory

Overview

AI-generated overview

A read-only Dropbox MCP server that lets an assistant list folders, search files by name or content, and read text from PDFs, DOCX and plain-text files.

What you can do
List files and folders in a Dropbox directory, with a cap on returned items and an optional folder path starting at the root. Search for files by name, optionally filtered by file type such as PDF, DOCX or TXT. Read a file's full content, with an optional character limit, extracting text from PDFs and DOCX documents as well as plain-text, code, HTML, CSS, JSON and CSV files. Get detailed metadata for a given file path. Search for specific text inside a chosen list of files and return surrounding context.
When to use it
Useful when your Dropbox holds documents, reports or code you want an assistant to find and read without downloading them by hand, for example locating an invoice by name or pulling key passages out of a PDF. It is aimed at read-only lookup and extraction rather than managing or editing files.
Requirements
A Dropbox account and an access token with the files.metadata.read and files.content.read scopes, supplied through the DROPBOX_ACCESS_TOKEN environment variable. The README describes a local Python 3.10+ setup with dependencies installed via pip; the registry entry lists a remote endpoint authenticated with an Authorization bearer token.
Before you install
The server holds a Dropbox access token that grants read access to your files, so keep it out of version control and prefer an app-scoped token with minimal permissions. File contents and metadata are sent to the assistant and, on the hosted endpoint, to the remote provider. Access is described as read-only, so it should not modify or delete anything.

Installation

In SourceWeft

  1. Open Cindyloo Dropbox Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.smithery%2Fcindyloo-dropbox-mcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "cindyloo-dropbox": {
      "type": "http",
      "url": "https://server.smithery.ai/@cindyloo/dropbox-mcp-server/mcp"
    }
  }
}

README

Dropbox MCP Server

A Model Context Protocol (MCP) server that provides read access to Dropbox files with advanced search and content extraction capabilities.

Features

  • File Listing: Browse files and folders in your Dropbox
  • File Reading: Read content from various file types (PDF, DOCX, TXT, code files)
  • Search: Search for files by name across your Dropbox
  • Content Search: Search for specific text within files
  • File Info: Get detailed metadata about files
  • Smart Text Extraction: Automatically extracts text from PDFs and DOCX files

Supported File Types

  • PDF - Text extraction with PyPDF2
  • DOCX/DOC - Document text extraction
  • Text files - TXT, MD, PY, JS, HTML, CSS, JSON, CSV

Installation

Prerequisites

  • Python 3.10 or higher
  • A Dropbox account and access token

Get a Dropbox Access Token

  1. Go to the Dropbox App Console
  2. Click "Create app"
  3. Choose "Scoped access" and "Full Dropbox" access
  4. Name your app
  5. Go to the "Permissions" tab and enable:
    • files.metadata.read
    • files.content.read
  6. Go to the "Settings" tab and generate an access token

Install Dependencies

bash
pip install -e .

Or install manually:

bash
pip install mcp dropbox pydantic PyPDF2 python-docx

Configuration

Set your Dropbox access token as an environment variable:

bash
export DROPBOX_ACCESS_TOKEN="your_access_token_here"

For Claude Desktop

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "dropbox": {      "command": "python",      "args": ["/path/to/your/dropbox_server.py"],      "env": {        "DROPBOX_ACCESS_TOKEN": "your_access_token_here"      }    }  }}

For Smithery

The server will automatically use the DROPBOX_ACCESS_TOKEN environment variable when deployed.

Available Tools

list_files

List files and folders in a Dropbox directory.

Parameters:

  • folder_path (optional): Path to folder (empty for root)
  • max_files (optional): Maximum items to return (default: 20)

search_files

Search for files by name.

Parameters:

  • query: Search query
  • file_types (optional): File types to search ("all", "pdf", "docx", "txt", or comma-separated)
  • max_results (optional): Maximum results (default: 10)

read_file

Read the full content of a file.

Parameters:

  • file_path: Full path to the file
  • max_length (optional): Maximum characters to return (default: 5000, 0 for unlimited)

get_file_info

Get detailed metadata about a file.

Parameters:

  • file_path: Full path to the file

search_file_content

Search for text within specific files.

Parameters:

  • file_paths: List of file paths to search
  • query: Text to search for
  • context_chars (optional): Characters of context around matches (default: 100)

Usage Examples

List files in root directory

python
list_files()

Search for PDF files

python
search_files(query="invoice", file_types="pdf", max_results=5)

Read a specific file

python
read_file(file_path="/documents/report.pdf")

Search within files

python
search_file_content(    file_paths=["/documents/file1.txt", "/documents/file2.pdf"],    query="important keyword")

Development

Running Locally

bash
python dropbox_server.py

Testing

Make sure your DROPBOX_ACCESS_TOKEN is set, then run the server and test with an MCP client.

Security Notes

  • Keep your Dropbox access token secure and never commit it to version control
  • Use environment variables or secure secret management
  • The server only provides read access to Dropbox files
  • Consider using app-scoped tokens with minimal permissions

License

MIT License - feel free to use and modify as needed.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For issues and questions, please open an issue on GitHub.

Source: README.md at commit 5f4a268

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.15.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Smithery integrations

222wcnm Bilistalkermcp

ai.smitheryOfficial publisher

Bilibili creator analysis server that lets an assistant look up a specific user's profile, videos, dynamics, articles, subtitles, followings and comments.

Streamable HTTPWeb executable
Web Search & ScrapingNot indexed yetOct 24, 2026

Zwldarren Akshare One Mcp

ai.smitheryOfficial publisher

Remote MCP server that gives an assistant read-only access to Chinese stock market data: historical and real-time prices, news, and financial statements.

Streamable HTTPWeb executableAuth
FinanceCredential requiredOct 24, 2026

Zhaoganghao Hellomcp

ai.smitheryOfficial publisher

A small remote MCP server that lets an assistant greet people by name and share background on the origin of 'Hello, World'.

Streamable HTTPWeb executable
Not indexed yetOct 24, 2026

Zeta Chain Cli

ai.smitheryOfficial publisher

A remote MCP server that lets an assistant generate friendly, customizable greetings for any name or audience.

Streamable HTTPWeb executableAuth
Credential requiredOct 24, 2026

Yuna0x0 Hackmd Mcp

ai.smitheryOfficial publisher

An MCP server that connects an assistant to the HackMD API so it can read, create, update and delete HackMD notes and manage teams.

Streamable HTTPWeb executable
Productivity & WorkflowNot indexed yetOct 25, 2026