Log inSubmit server
Nestr MCP logo

Nestr MCP

by nestr-dev

Connect AI assistants to Nestr workspaces to manage nests, recurring work, comments, and organizational structures.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Nestr MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-348": {
      "command": "npx",
      "args": [
        "-y",
        "@nestr/mcp"
      ],
      "env": {
        "NESTR_API_KEY": "YOUR_VALUE_HERE",
        "NESTR_OAUTH_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

nestr-dev/nestr-mcp MCP server connects AI assistants to Nestr workspaces through hosted HTTP or a local npm process. It supports searching, reading, creating, updating, organizing, and deleting nests such as tasks, projects, and roles, along with workspace and organizational data. Additional tools cover recurrence, comments, activity, circles, roles, and users. Reach for it when an assistant needs to inspect or change work managed in Nestr.

Use cases

  • Search tasks, projects, and roles in a Nestr workspace
  • Create and update nests from an AI assistant
  • Inspect circle roles, accountabilities, and domains
  • Manage recurring tasks and individual occurrences
  • Review comments and nest activity

Key features

  • Search and manage Nestr nests
  • Inspect provenance and effective permissions
  • Manage recurrence and occurrences
  • Read and update comments
  • Query circles, roles, and workspace users
  • Connect related nests with graph links

Tools69

What Nestr MCP lets your agent do. Expand a tool for its parameters.

Self-reported~1.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

8/8 checks healthy over the last 47d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @nestr/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6Stargazers on the source repository.
npm downloads1.4kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Tools exposed69Callable tools this server registers over MCP.

How Nestr MCP works

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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Nestr MCP

nestr-dev/nestr-mcp is an MCP server that connects AI assistants to Nestr workspaces. Its main tools search and manage tasks, projects, and roles; inspect circles and permissions; handle recurrence, comments, and activity; and retrieve workspace members and details. It supports hosted OAuth and local authenticated operation.

Use the hosted MCP endpoint or run the npm package locally. Add https://mcp.nestr.io/mcp to a supported client and authenticate, or run `npx @nestr/mcp` and configure the client to launch `npx -y @nestr/mcp`.

Authenticate with OAuth through the hosted service or provide a Nestr API key or OAuth token for local use. Set `NESTR_API_KEY` or `NESTR_OAUTH_TOKEN`; API keys are created in Nestr under Settings, Integrations, and Workspace API access.

Yes, Cursor is named in the setup guidance. The hosted service provides setup instructions for Cursor, and the server connects through the remote MCP endpoint at `https://mcp.nestr.io/mcp`.

Related MCP servers

All in Communication All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewNestr MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-348?style=directory)](https://allmcps.com/mcp/mcp-348)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-348"><img src="https://allmcps.com/api/badge/mcp-348?style=directory" alt="Nestr MCP on AllMCPs" /></a>