# nestr-dev/nestr-mcp [Health: Active]

**Category:** 💬 Communication  
**Repository:** https://github.com/nestr-dev/nestr-mcp  
**GitHub Stars:** 6  
**npm Downloads (last month):** 1410  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-348

## Description
Connect AI to Nestr for Holacracy, Sociocracy, and self-organizing teams.

## Tools
Capabilities this server exposes over MCP:

- **nestr_list_workspaces** — List accessible workspaces
- **nestr_get_workspace** — Get workspace details
- **nestr_create_workspace** — Create a new workspace (OAuth only)
- **nestr_search** — Search for nests (tasks, projects, roles)
- **nestr_get_me** — Get current user identity and workspace list
- **nestr_get_nest** — Get details of a specific nest (supports batch fetch with comma-separated IDs; single-nest `provenance`/`rights`/`whoCan` flags available)
- **nestr_explain_nest** — Diagnose one nest: field/property provenance (which label/circle defines each), the caller's composed rights with a deny trace, and (with `whoCan`) who can act on it and who to contact
- **nestr_get_nest_children** — Get child nests
- **nestr_create_nest** — Create a new nest
- **nestr_update_nest** — Update nest properties
- **nestr_delete_nest** — Delete a nest
- **nestr_reorder_nest** — Reorder a nest relative to another
- **nestr_bulk_reorder** — Bulk reorder multiple nests
- **nestr_add_label** — Add a label to a nest
- **nestr_remove_label** — Remove a label from a nest
- **nestr_set_recurrence** — Set or remove a task, project or meeting's recurrence rule
- **nestr_list_occurrences** — List a series' occurrences, virtual and materialized, each with the `instant` the tools below take
- **nestr_skip_occurrence** — Skip one occurrence without ending the series, or with `scope: "following"` delete it and every later one
- **nestr_update_occurrence** — Edit one occurrence, materializing it first if it is still virtual
- **nestr_delete_series** — Delete a whole series, past occurrences included
- **nestr_add_comment** — Add a comment to a nest
- **nestr_get_comments** — Get comments/discussion on a nest
- **nestr_get_nest_activity** — What happened on a nest and beneath it, with each change as data
- **nestr_update_comment** — Update a comment
- **nestr_delete_comment** — Delete a comment
- **nestr_list_circles** — List organizational circles
- **nestr_get_circle** — Get circle details
- **nestr_get_circle_roles** — Get roles in a circle with accountabilities and domains
- **nestr_list_roles** — List all roles
- **nestr_list_users** — List workspace members
- **nestr_get_user** — Get user details
- **nestr_add_workspace_user** — Add a user to the workspace and email them an invite (API provisioning needs a verified domain; the in-app invite does not)
- **nestr_create_tension** — Create a tension on a circle or role
- **nestr_get_tension** — Get tension details
- **nestr_list_tensions** — List tensions on a circle or role
- **nestr_update_tension** — Update a tension
- **nestr_delete_tension** — Delete a tension
- **nestr_get_tension_parts** — Get proposal parts of a tension
- **nestr_add_tension_part** — Add a proposal part (new/changed governance item)
- **nestr_modify_tension_part** — Modify a proposal part
- **nestr_remove_tension_part** — Remove a proposal part
- **nestr_get_tension_part_children** — Get children (accountabilities/domains) of a proposal part
- **nestr_create_tension_part_child** — Add a child to a proposal part
- **nestr_update_tension_part_child** — Update a proposal part child
- **nestr_delete_tension_part_child** — Delete a proposal part child
- **nestr_get_tension_changes** — Preview the diff a proposal part would apply
- **nestr_get_tension_status** — Get voting status for a tension
- **nestr_update_tension_status** — Submit for voting or retract to draft
- **nestr_get_graph_links** — Get nests linked via a named relation (e.g., meeting agenda items)
- **nestr_add_graph_link** — Create a bidirectional link between two nests
- **nestr_remove_graph_link** — Remove a link between two nests
- **nestr_list_labels** — List workspace labels
- **nestr_get_label** — Get label details
- **nestr_get_projects** — List projects with status
- **nestr_get_insights** — Get workspace metrics
- **nestr_get_insight_history** — Get historical trend data for a metric
- **nestr_get_workspace_apps** — List enabled apps/features
- **nestr_list_inbox** — List items in user's inbox
- **nestr_create_inbox_item** — Quick capture to inbox
- **nestr_get_inbox_item** — Get inbox item details
- **nestr_update_inbox_item** — Update inbox item
- **nestr_reorder_inbox** — Reorder inbox items
- **nestr_list_personal_labels** — List user's personal labels
- **nestr_create_personal_label** — Create a personal label
- **nestr_get_daily_plan** — Get items marked for today
- **nestr_add_to_daily_plan** — Add items to today's focus
- **nestr_remove_from_daily_plan** — Remove items from today's focus
- **nestr_list_my_tensions** — List tensions authored by or assigned to you
- **nestr_list_tensions_awaiting_consent** — List governance proposals needing your vote

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "nestr-mcp": {
    "command": "npx",
    "args": ["-y","@nestr/mcp"],
    "env": {
      "NESTR_API_KEY": "",
      "NESTR_OAUTH_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `NESTR_API_KEY`, `NESTR_OAUTH_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What nestr-dev/nestr-mcp does

nestr-dev/nestr-mcp MCP server gives compatible AI clients access to Nestr workspaces. It is suited to the Workplace & Productivity category and covers both operational work and the structures used by Holacracy, Sociocracy, and self-organizing teams.

The server can list accessible workspaces, retrieve workspace details, identify the authenticated user, and search Nestr for tasks, projects, and roles. Nest operations include reading details, fetching children, creating, editing, deleting, reordering, and applying or removing labels. A nest can also be inspected for property provenance, effective rights, deny reasons, and, when requested, people who can act on it.

For collaboration, the available operations include adding, reading, editing, and deleting comments, plus retrieving activity for a nest and its descendants. Organizational queries cover circles, circle roles with accountabilities and domains, workspace roles, and workspace members.

## How it works

The hosted service is available at `https://mcp.nestr.io/mcp` and uses OAuth authentication through the client. OAuth access follows the signed-in user's Nestr permissions. The package can also run locally through npm and authenticate with a Nestr API key or OAuth token. API-key access provides full workspace access regardless of user permissions, so the authentication choice affects the scope of changes an assistant can make.

Beyond basic nest management, tools handle recurring tasks, projects, and meetings. They can set or remove recurrence, list virtual and materialized occurrences, skip one occurrence or all following occurrences, update an occurrence, and delete an entire series. Graph-link operations connect nests through named relationships, while the available workspace tools also include labels, project lists, metrics, insight history, and enabled workspace apps.

## Setup and configuration

For the hosted option, add the remote MCP URL in Claude Desktop or use the Claude Code HTTP command, then authenticate in the browser. Cursor is also named in the setup guidance, with step-by-step instructions available from the hosted service.

For local use, run `npx @nestr/mcp` and configure the MCP client to launch `npx -y @nestr/mcp`. Set either `NESTR_API_KEY` or `NESTR_OAUTH_TOKEN` in the client environment. API keys are created in a Nestr workspace under Settings, Integrations, and Workspace API access. The hosted route handles OAuth without requiring a local environment variable.

## Tools and capabilities

nestr-dev/nestr-mcp exposes tools for:

- Workspace discovery, identity, search, and workspace creation; workspace creation requires OAuth.
- Nest CRUD operations, child lookup, reordering, labels, provenance, rights, and actionability checks.
- Recurrence rules and occurrence-level changes.
- Comments, discussions, and activity history.
- Circles, roles, accountabilities, domains, and users.
- Graph links between related nests.
- Personal inbox, daily-plan, personal-label, and tension tools where supported by OAuth.

It can display tasks and projects, allow completion and inline title edits, support drag-and-drop ordering, show parent context, and link back to Nestr.

## Limitations and notes

nestr-dev/nestr-mcp requires authentication for local operation. OAuth-only tools include workspace creation and the personal tools; API keys do not reproduce user-specific permission filtering. API-key authentication instead grants full workspace access, making credential handling important when enabling write or delete operations.

Interactive UI behavior depends on MCP client support for MCP Apps. Clients without that support can still use the underlying tools through their normal MCP interface. The supplied setup documentation specifically names Claude Desktop, Claude Code, and Cursor.

_Full upstream README: https://allmcps.com/mcp/mcp-348/readme_