tangled-mcp

MCP server for Tangled - a git collaboration platform built on AT Protocol.

note: this repository is mirrored to GitHub for deployment via FastMCP Cloud.

installation

git clone https://tangled.org/zzstoatzz/tangled-mcp
cd tangled-mcp
just setup

[!IMPORTANT] requires uv and just

configuration

create .env file:

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

usage

MCP client installation instructions

claude code

# basic setup
claude mcp add tangled -- uvx tangled-mcp

# with credentials
claude mcp add tangled \
  -e TANGLED_HANDLE=your.handle \
  -e TANGLED_PASSWORD=your-app-password \
  -- uvx tangled-mcp

cursor

add to your cursor settings (~/.cursor/mcp.json or .cursor/mcp.json):

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

codex cli

codex mcp add tangled \
  --env TANGLED_HANDLE=your.handle \
  --env TANGLED_PASSWORD=your-app-password \
  -- uvx tangled-mcp

other clients

for clients that support MCP server configuration, use:

command: uvx
args: ["tangled-mcp"]
environment variables: TANGLED_HANDLE, TANGLED_PASSWORD, and optionally TANGLED_PDS_URL

development usage

uv run tangled-mcp

resources

tangled://status - connection status (PDS auth + tangled accessibility)

tools

all tools accept repositories in owner/repo format (e.g., zzstoatzz/tangled-mcp). handles (with or without @ prefix) and DIDs are both supported for the owner.

repositories

list_repo_branches(repo, limit, cursor) - list branches for a repository

issues

create_repo_issue(repo, title, body, labels) - create an issue with optional labels
update_repo_issue(repo, issue_id, title, body, labels) - update an issue's title, body, and/or labels
delete_repo_issue(repo, issue_id) - delete an issue
list_repo_issues(repo, limit, cursor) - list issues for a repository
list_repo_labels(repo) - list available labels for a repository

development

just test   # run tests
just check  # run pre-commit checks

mcp-name: io.github.zzstoatzz/tangled-mcp

Metadata

Release files for tangled-mcp 0.0.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tangled-mcp 0.0.14
File	Size	Uploaded
tangled_mcp-0.0.14.tar.gz	119.7 kB	Oct 23, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for tangled-mcp 0.0.14
File	Interpreter	ABI	Platform	Reset
tangled_mcp-0.0.14-py3-none-any.whl 13.8 kB Oct 23, 2025	Python 3	none	any	Details

Total release size: 133.5 kB

Release files / tangled_mcp-0.0.14.tar.gz

Download URL	tangled_mcp-0.0.14.tar.gz
Size	119.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`65deefac6a6c13c22e0c557b0cea45da7354665f77b2a8395f9e049a3f0cc555`
BLAKE2b-256 checksum How to use checksums	`9f67d198748247e446651fd980e54a73bc3f51af1e68a3f1af46cb6d78e2b7b7`
Upload date	Oct 23, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.5`

Release files / tangled_mcp-0.0.14-py3-none-any.whl

Download URL	tangled_mcp-0.0.14-py3-none-any.whl
Size	13.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a1efcdcfd837ae61cdf51994c5d26d292126562a2078459186cc9f76d64c10d2`
BLAKE2b-256 checksum How to use checksums	`0df3e0cefc675381b2212c949f10466b489e893e9b419ca5e88199718252156a`
Upload date	Oct 23, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.9.5`