MyCouch is the asynchronous CouchDB client for .NET
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
resources Logo Feb 21, 2015
source Updates NuGet packages Ensure.That and Newtonsoft.Json Apr 29, 2018
tools Updates buildscript etc. Apr 29, 2018
.gitignore Include testenvironments.json Apr 1, 2017
build.cake Updates buildscript etc. Apr 29, 2018
build.ps1 use Cake for builds Mar 26, 2017
buildconfig.cake Updates buildscript etc. Apr 29, 2018


The asynchronous CouchDB client for .NET - builds on top of the asynchronous HTTP client and uses JSON.Net to provide flexible serialization behaviour. It tries to keep the domain language of CouchDB instead of bringing in generic repositories and other confusing stuff. MyCouch lets you work with raw JSON and/or entities/POCOS without requiring any implementation of interfaces, baseclasses etc. MyCouch provides you with some model conventions like injection of $doctype to the document.

Multiple target frameworks: .NET4.5.1, .NET Standard 1.1, .NET Standard 2.0; using a .NET Standard project.


The documentation is contained in the project wiki.

Quick sample - using Requests and Responses

using(var client = new MyCouchClient("http://localhost:5984/", "mydb"))
    //POST with server generated id
    await client.Documents.PostAsync("{\"name\":\"Daniel\"}");

	//POST with client generated id - possible but wrong
    await client.Documents.PostAsync("{\"_id":\"someId", \"name\":\"Daniel\"}");

    //PUT for client generated id
    await client.Documents.PutAsync("someId", "{\"name\":\"Daniel\"}");

    //PUT for updates
    await client.Documents.PutAsync("someId", "docRevision", "{\"name\":\"Daniel Wertheim\"}");

	//PUT for updates with _rev in JSON
    await client.Documents.PutAsync("someId", "{\"_rev\": \"docRevision\", \"name\":\"Daniel Wertheim\"}");

    //Using entities
    var me = new Person {Id = "SomeId", Name = "Daniel"};
    await client.Entities.PutAsync(me);

    //Using anonymous entities
    await client.Entities.PostAsync(new { Name = "Daniel" });
using(var client = new MyCouchServerClient("http://localhost:5984"))
    var r = await client.Replicator.ReplicateAsync(id, source, target);

Quick sample - using MyCouchStore

using(var store = new MyCouchStore("http://localhost:5984", "mydb"))
    var mySomething = await store.StoreAsync(new Something("foo", "bar", 42));

    var retrieved = await store.GetByIdAsync(mySomething.Id);

    var deleted = await store.DeleteAsync(mySomething.Id, mySomething.Rev);

    //... ... and so on... ...

Issues, questions, etc

So you have issues or questions... Great! That means someone is using it. Use the issues function here at the project page or contact me via mail:; or Twitter: @danielwertheim