couchdb_update_document

Update an existing document in a CouchDB database by specifying the database name, document ID, and revised document data including the _rev field.

Instructions

Update an existing document in a database

Input Schema

TableJSON Schema

Name	Required	Description
`database`	Yes	Name of the database
`doc_id`	Yes	Document ID
`document`	Yes	Updated document data (must include _rev)

Implementation Reference

couchdb_mcp_server.py:378-401 (handler)

The _update_document method implements the actual logic for updating a CouchDB document. It retrieves the database, ensures the document has _id, saves it using db.save(), and handles various error cases (KeyError for missing database, ResourceConflict for revision conflicts, and general exceptions). Returns the updated document id and revision.

async def _update_document(self, database: str, doc_id: str, document: dict) -> list[TextContent]:
    """Update an existing document."""
    try:
        db = self._get_server()[database]

        # Ensure document has _id
        if "_id" not in document:
            document["_id"] = doc_id

        # Save the document
        saved_id, rev = db.save(document)

        result = {
            "id": saved_id,
            "rev": rev,
            "message": "Document updated successfully"
        }
        return [TextContent(type="text", text=json.dumps(result, indent=2))]
    except KeyError:
        return [TextContent(type="text", text=f"Database '{database}' not found")]
    except couchdb.http.ResourceConflict:
        return [TextContent(type="text", text="Document update conflict - document was modified, please get the latest revision")]
    except Exception as e:
        return [TextContent(type="text", text=f"Error updating document: {str(e)}")]

couchdb_mcp_server.py:131-152 (schema)

Tool schema definition for couchdb_update_document, registered in the list_tools() handler. Defines the input schema with database (string), doc_id (string), and document (object) as required fields. The document parameter note specifies it must include _rev for optimistic concurrency control.

Tool(
    name="couchdb_update_document",
    description="Update an existing document in a database",
    inputSchema={
        "type": "object",
        "properties": {
            "database": {
                "type": "string",
                "description": "Name of the database",
            },
            "doc_id": {
                "type": "string",
                "description": "Document ID",
            },
            "document": {
                "type": "object",
                "description": "Updated document data (must include _rev)",
            },
        },
        "required": ["database", "doc_id", "document"],
    },
),

couchdb_mcp_server.py:283-288 (registration)
Tool routing registration in the call_tool() handler that routes the 'couchdb_update_document' tool name to its handler method _update_document(), extracting the database, doc_id, and document arguments.
```
elif name == "couchdb_update_document":
    return await self._update_document(
        arguments["database"],
        arguments["doc_id"],
        arguments["document"]
    )
```

CouchDB MCP Server