MCP server that gives AI agents access to DocuWare document management systems.
Note
This is an independent project by ARJOMA FlexCo and is not an official DocuWare product. DocuWare is a trademark of DocuWare GmbH.
→ Setup Guide | Einrichtungsanleitung (Deutsch)
uvx docuware-mcp setup # authenticate with DocuWare
uvx docuware-mcp --name PROFILE install --tool claude-desktop # register with Claude Desktop
uvx docuware-mcp --name PROFILE install --tool claude-code # register with Claude Code
uvx docuware-mcp --name PROFILE install --tool codex # register with CodexPROFILE is the name you chose during setup (e.g. acme).
A DocuWare admin must create an App Registration (type: Native Application, PKCE, Refresh Token active). → Details: docs/admin-guide-app-registration.md
- Search documents across file cabinets with flexible field conditions
- Retrieve document content (text extraction) and metadata
- Explore file cabinets, search dialogs, and available fields
- Automatic session renewal via browser re-login
| Tool | Description |
|---|---|
list_documents |
List or search documents (search dialogs + list dialogs) |
get_document |
Get document metadata, stamps, and/or text. Accepts a list of IDs for batch fetch; fields=[...] whitelist |
get_document_content |
Get a direct link to view the document |
resolve_field_value |
Fuzzy-match informal field names/values to exact DB values |
preview_field_values |
Preview distinct values for a field (like a dropdown) |
| Command | Description |
|---|---|
uvx docuware-mcp --name PROFILE setup |
Authenticate with DocuWare (browser login) |
uvx docuware-mcp --name PROFILE install --tool TOOL |
Register MCP server with AI client |
uvx docuware-mcp --name PROFILE status |
Check connection status |
uvx docuware-mcp --name PROFILE |
Start MCP server (stdio transport) |
OAuth2 tokens are stored in the OS keyring (via keyring) — no passwords saved. App configuration (Client ID, endpoints) is in ~/.config/docuware-mcp/<profile>/app.json.
See DEVELOPMENT.md.
- Python 3.10+
- uv (recommended) or pip
Apache License 2.0 — see LICENSE.
Copyright (c) 2026 Harald Schilly, ARJOMA FlexCo
Harald Schilly info@arjoma.at