AI for Holacracy, Sociocracy & Self-Organizing Teams
Connect Claude, ChatGPT, Gemini, and other AI assistants to Nestr — the platform for self-organizing teams. Manage circles, roles, governance proposals, tactical meetings, and tensions through natural conversation.
Teach Your AI Agent About Nestr
Give your AI agent deep knowledge about Nestr's data model, governance concepts, API, and best practices — so it can help you build integrations, automations, and tools.
Read https://nestr.demo.jorisslagter.nl/SKILL.md and follow the instructions to work with Nestr
This works with any AI agent that can read URLs — no MCP setup required. For full MCP integration, see the Setup Guide below.
What is Nestr?
Nestr is the platform for teams practicing Holacracy, Sociocracy, and other forms of self-organization. It helps you manage your organizational structure with circles and roles, run governance and tactical meetings, track tensions, and distribute authority across your team.
The Nestr MCP Server brings AI into your self-management practice — and your self-organization practice into your favorite AI chatbot. Query your organizational structure, capture tensions, prepare for governance and tactical meetings, and manage projects, all through natural conversation.
What Can You Do?
Structure
Navigate your governance structure: circles, roles, accountabilities, domains, and policies. Understand who is accountable for what.
Work
Manage projects, actions, and tensions within your roles. Track what needs to get done, capture gaps between current and ideal reality, and move work forward.
Communicate
Add updates, comments, and context to any item. Prepare for tactical and governance meetings, and keep your circle informed on progress and blockers.
Insights
Monitor the health of your self-organizing practice. Track metrics, review activity patterns, and identify where your organization may need attention.
Setup Guide
Choose Your Authentication Method
To get an API key:
- Go to your Nestr workspace
- Click the Settings icon (gear) in the top right
- Navigate to the Integrations tab
- Find "Workspace API access" and click Configure
- Click "New API key" and copy the generated key
Choose Your Setup Method
Configure Your AI Client
Works for both claude.ai (web) and Claude Desktop app. Connectors sync across both.
Quickstart (Recommended)
Step 1: In Claude, go to Settings → Connectors → Add custom connector
Step 2: Fill in the following:
| Name | Nestr |
| Remote MCP URL | https://mcp.nestr.io/mcp |
Step 3: Click "Add" and then "Authenticate" to log in with your Nestr account.
That's it! Claude will handle the OAuth flow automatically.
Go to Settings → Connectors → Add custom connector and fill in:
| Name | Nestr |
| Remote MCP URL | https://mcp.nestr.io/mcp |
| Headers | X-Nestr-API-Key: your-api-key-here |
Local setup only works with the Claude Desktop app, not claude.ai web.
Edit your Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"nestr": {
"command": "npx",
"args": ["-y", "@nestr/mcp"],
"env": {
"NESTR_OAUTH_TOKEN": "your-oauth-token-here"
}
}
}
}Restart Claude Desktop after saving.
Local setup only works with the Claude Desktop app, not claude.ai web.
Edit your Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"nestr": {
"command": "npx",
"args": ["-y", "@nestr/mcp"],
"env": {
"NESTR_API_KEY": "your-api-key-here"
}
}
}
}Restart Claude Desktop after saving.
Quickstart (Recommended)
Step 1: Add the Nestr MCP server:
claude mcp add --scope user nestr --transport http https://mcp.nestr.io/mcpStep 2: In Claude Code, run /mcp and click "Authenticate" next to Nestr. This will open your browser to log in with Nestr.
That's it! Once authenticated, Claude Code can access your Nestr workspace.
Or, if you already have a token, add it manually:
claude mcp add --scope user nestr --transport http https://mcp.nestr.io/mcp \
--header "Authorization: Bearer your-oauth-token-here"Run this command in your terminal:
claude mcp add --scope user nestr --transport http https://mcp.nestr.io/mcp \
--header "X-Nestr-API-Key: your-api-key-here"Run this command in your terminal:
claude mcp add --scope user nestr -- npx -y @nestr/mcp \
--env NESTR_OAUTH_TOKEN=your-oauth-token-hereRun this command in your terminal:
claude mcp add --scope user nestr -- npx -y @nestr/mcp \
--env NESTR_API_KEY=your-api-key-hereRun /mcp anytime to check connection status or re-authenticate.
Already set up Nestr as a Claude.ai connector? You can reuse it in Claude Code by enabling the flag:
claude config set --global tengu_claudeai_mcp_connectors true
This makes all your Claude.ai connectors available in Claude Code — no separate MCP setup needed.
In Cursor, go to Settings → Cursor Settings → MCP Servers, or edit the config file:
- macOS/Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
Add the following configuration:
{
"mcpServers": {
"nestr": {
"url": "https://mcp.nestr.io/mcp",
"headers": {
"Authorization": "Bearer your-oauth-token-here"
}
}
}
}Add the following configuration:
{
"mcpServers": {
"nestr": {
"url": "https://mcp.nestr.io/mcp",
"headers": {
"X-Nestr-API-Key": "your-api-key-here"
}
}
}
}Add the following configuration:
{
"mcpServers": {
"nestr": {
"command": "npx",
"args": ["-y", "@nestr/mcp"],
"env": {
"NESTR_OAUTH_TOKEN": "your-oauth-token-here"
}
}
}
}Add the following configuration:
{
"mcpServers": {
"nestr": {
"command": "npx",
"args": ["-y", "@nestr/mcp"],
"env": {
"NESTR_API_KEY": "your-api-key-here"
}
}
}
}Restart Cursor after saving.
Works for chatgpt.com (web), desktop app, and mobile. Apps sync across all.
Quickstart
Step 1: In ChatGPT, go to Settings → Apps → Advanced settings and enable Developer Mode
Step 2: Click Add more, then Create to add a new app:
| Name | Nestr |
| Server URL | https://mcp.nestr.io/mcp |
Step 3: Check "I trust this provider" and click Create
Step 4: In each chat, click + → More → Developer Mode and enable Nestr
ChatGPT will prompt you to authenticate with Nestr when the app is first used.
Step 1: In ChatGPT, go to Settings → Apps → Advanced settings and enable Developer Mode
Step 2: Click Add more, then Create to add a new app:
| Name | Nestr |
| Server URL | https://mcp.nestr.io/mcp |
| Authentication | Add header X-Nestr-API-Key: your-api-key-here |
Step 3: Check "I trust this provider" and click Create
Step 4: In each chat, click + → More → Developer Mode and enable Nestr
ChatGPT only supports remote MCP servers. Please use the Cloud setup method for ChatGPT.
ChatGPT only supports remote MCP servers. Please use the Cloud setup method for ChatGPT.
Works with Microsoft Copilot Studio agents and Microsoft 365 Copilot declarative agents.
Quickstart
Step 1: In Copilot Studio, open your agent and go to Tools → Add Tool → New Tool → MCP
Step 2: Enter the server URL:
| URL | https://mcp.nestr.io/mcp |
Step 3: Save and publish your agent
Copilot Studio will prompt you to authenticate with Nestr when the tools are first used.
Step 1: In Copilot Studio, open your agent and go to Tools → Add Tool → New Tool → MCP
Step 2: Enter the server URL and authentication:
| URL | https://mcp.nestr.io/mcp |
| Header | X-Nestr-API-Key: your-api-key-here |
Step 3: Save and publish your agent
Copilot Studio only supports remote MCP servers. Please use the Cloud setup method.
Copilot Studio only supports remote MCP servers. Please use the Cloud setup method.
Configure the Nestr MCP server in your Gemini CLI settings file:
- macOS/Linux:
~/.gemini/settings.json - Windows:
%USERPROFILE%\.gemini\settings.json
Add the following configuration:
{
"mcpServers": {
"nestr": {
"httpUrl": "https://mcp.nestr.io/mcp",
"headers": {
"Authorization": "Bearer your-oauth-token-here"
}
}
}
}Add the following configuration:
{
"mcpServers": {
"nestr": {
"httpUrl": "https://mcp.nestr.io/mcp",
"headers": {
"X-Nestr-API-Key": "your-api-key-here"
}
}
}
}Add the following configuration:
{
"mcpServers": {
"nestr": {
"command": "npx",
"args": ["-y", "@nestr/mcp"],
"env": {
"NESTR_OAUTH_TOKEN": "your-oauth-token-here"
}
}
}
}Add the following configuration:
{
"mcpServers": {
"nestr": {
"command": "npx",
"args": ["-y", "@nestr/mcp"],
"env": {
"NESTR_API_KEY": "your-api-key-here"
}
}
}
}Restart Gemini CLI after saving.
Configure VS Code to use the Nestr MCP server with GitHub Copilot Chat.
One-Click Install
Click the button below to add Nestr to VS Code:
Add to VS CodeAfter installation, authenticate via the GitHub Copilot Chat panel.
Button not working? Show manual setup
One-Click Install
Click the button below to add Nestr to VS Code (you'll need to add your API key after):
Add to VS CodeButton not working? Show manual setup
Edit your VS Code settings (.vscode/mcp.json or user settings):
{
"servers": {
"nestr": {
"command": "npx",
"args": ["-y", "@nestr/mcp"],
"env": {
"NESTR_OAUTH_TOKEN": "your-oauth-token-here"
}
}
}
}Edit your VS Code settings (.vscode/mcp.json or user settings):
{
"servers": {
"nestr": {
"command": "npx",
"args": ["-y", "@nestr/mcp"],
"env": {
"NESTR_API_KEY": "your-api-key-here"
}
}
}
}Reload VS Code window after saving (Cmd/Ctrl + Shift + P → "Developer: Reload Window").
OpenClaw (formerly ClawdBot / MoltBot) is an open-source AI assistant gateway. Add Nestr MCP to your ~/.openclaw/openclaw.json config:
{
"provider": {
"mcpServers": {
"nestr": {
"url": "https://mcp.nestr.io/mcp",
"headers": {
"Authorization": "Bearer your-oauth-token-here"
}
}
}
}
}{
"provider": {
"mcpServers": {
"nestr": {
"url": "https://mcp.nestr.io/mcp",
"headers": {
"X-Nestr-API-Key": "your-api-key-here"
}
}
}
}
}{
"provider": {
"mcpServers": {
"nestr": {
"command": "npx",
"args": ["-y", "@nestr/mcp"],
"env": {
"NESTR_OAUTH_TOKEN": "your-oauth-token-here"
}
}
}
}
}{
"provider": {
"mcpServers": {
"nestr": {
"command": "npx",
"args": ["-y", "@nestr/mcp"],
"env": {
"NESTR_API_KEY": "your-api-key-here"
}
}
}
}
}Restart the OpenClaw gateway after saving: openclaw gateway restart
For other MCP clients, use these configuration details:
| MCP Server URL | https://mcp.nestr.io/mcp |
| Transport | HTTP (Streamable) |
| Authorization Header | Bearer your-oauth-token-here |
Or as JSON configuration:
{
"mcpServers": {
"nestr": {
"url": "https://mcp.nestr.io/mcp",
"headers": {
"Authorization": "Bearer your-oauth-token-here"
}
}
}
}| MCP Server URL | https://mcp.nestr.io/mcp |
| Transport | HTTP (Streamable) |
| Header | X-Nestr-API-Key: your-api-key-here |
Or as JSON configuration:
{
"mcpServers": {
"nestr": {
"url": "https://mcp.nestr.io/mcp",
"headers": {
"X-Nestr-API-Key": "your-api-key-here"
}
}
}
}| Command | npx -y @nestr/mcp |
| Transport | stdio |
| Environment | NESTR_OAUTH_TOKEN=your-oauth-token-here |
Or as JSON configuration:
{
"mcpServers": {
"nestr": {
"command": "npx",
"args": ["-y", "@nestr/mcp"],
"env": {
"NESTR_OAUTH_TOKEN": "your-oauth-token-here"
}
}
}
}| Command | npx -y @nestr/mcp |
| Transport | stdio |
| Environment | NESTR_API_KEY=your-api-key-here |
Or as JSON configuration:
{
"mcpServers": {
"nestr": {
"command": "npx",
"args": ["-y", "@nestr/mcp"],
"env": {
"NESTR_API_KEY": "your-api-key-here"
}
}
}
}Start Using It
Once configured, the Nestr tools are automatically available to your AI assistant. No special syntax or @ mentions needed — just ask naturally:
- "I have a tension about our hiring process — can you capture it?"
- "What circles do we have and who are the Lead Links?"
- "Show me all projects in the Product circle"
- "Who has the accountability for customer onboarding?"
- "Help me prepare for tomorrow's governance meeting"
Example Conversations
Available Tools
nestr_list_workspaces
List accessible workspaces
nestr_search
Search for tasks, projects, roles
nestr_create_nest
Create new tasks or projects
nestr_update_nest
Update nest properties
nestr_list_circles
List organizational circles
nestr_get_circle_roles
Get roles in a circle
nestr_get_insights
Get workspace metrics
nestr_add_comment
Add comments to nests