Tangled

MCP server for tangled.org

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "zzstoatzz-tangled-mcp": {
      "command": "uvx",
      "args": [
        "tangled-mcp"
      ],
      "env": {
        "TANGLED_HANDLE": "your.handle",
        "TANGLED_PASSWORD": "your-app-password"
      }
    }
  }
}

Tangled MCP Server lets you run a dedicated MCP endpoint for the Tangled git collaboration platform built on AT Protocol. It enables MCP clients to connect, authenticate with Tangled, and perform repository, issue, and pull request operations through MCP protocol flows.

How to use

You run Tangled MCP locally or in your environment and connect your MCP clients to it. Start the server using the standard runtime command, then configure your MCP clients with the provided handle and credentials. Once connected, you can manage repositories, issues, pull requests, and other Tangled-backed resources through MCP-based tooling.

How to install

# Prerequisites
# Install or ensure these are available on your system
# uv: a lightweight task runner/runner for MCP workflows
# just: a task runner for setup and build steps

# Install the MCP server locally
git clone https://tangled.org/zzstoatzz/tangled-mcp
cd tangled-mcp
just setup

Configuration and usage notes

Create a configuration file with your Tangled credentials and optional PDS URL. This enables the MCP server to authenticate with Tangled and discover your PDS (personal data store) endpoint if you are using a custom PDS.

TANGLED_HANDLE=your.handle
TANGLED_PASSWORD=your-app-password
# optional: only needed if using custom PDS (leave blank for auto-discovery)
TANGLED_PDS_URL=

MCP client connection example

You can connect an MCP client by using the standard runtime command that runs the Tangled MCP server. This example shows how to configure a client to start Tangled MCP using the uvx runtime.

# Example: start the Tangled MCP server via uvx
uvx tangled-mcp

# With credentials passed via environment variables
TANGLED_HANDLE=your.handle TANGLED_PASSWORD=your-app-password uvx tangled-mcp

Development usage

During development, you can run the MCP server directly to test changes.

uv run tangled-mcp

Available tools

list_repo_branches

List branches for a repository in owner/repo format.

create_repo_issue

Create an issue in a repository with optional labels.

update_repo_issue

Update an existing issue's title, body, or labels.

delete_repo_issue

Delete an issue from a repository.

list_repo_issues

List issues for a repository with an optional limit.

list_repo_labels

List available labels for a repository.

list_repo_pulls

List pull requests for a repository that you created.